Tooty CMS Themes

Default theme repository for Tooty CMS.

This repo contains the official starter/default themes used by Tooty core. Community themes are welcome.

Purpose

• Ship stable, reusable themes for Tooty CMS
• Keep theme behavior in themes (not core)
• Provide a clean baseline for new installs

Community Contributions

Community themes are welcome via pull request.

Before opening a PR, your theme must pass the repo CI checks and follow these rules.

Theme Rules (Required)

1. One folder per theme at repo root, e.g. my-theme.
2. Folder name must match theme.json.id.
3. Each theme must include theme.json with:

• id
• name
• description
• version
• minCoreVersion

4. version must be semver-like (example: 0.1.0, 0.2.2-1).
5. minCoreVersion must match Tooty range format (example: 0.2.x).
6. Include templates/index.html.
7. Include templates/home.html or set templates.home in theme.json.
8. Include single template (templates/single.html preferred; legacy post.html allowed).
9. Include archive template (templates/archive.html preferred; legacy posts.html allowed).
10. Include taxonomy template (templates/taxonomy.html or templates/taxonomy-category.html; legacy tax_category_documentation.html allowed).
11. Add templates/404.html (recommended).
12. All files referenced in theme.json.assets must exist.
13. No secrets, binaries, malware patterns, or .DS_Store files.
14. Keep themes presentation-only. Do not implement auth/routing/schema bypass logic.

Quick Start: Create a Basic Theme

1. Create a folder:

• my-theme/

2. Add my-theme/theme.json:

{
  "id": "my-theme",
  "name": "My Theme",
  "description": "Minimal starter theme.",
  "version": "0.1.0",
  "minCoreVersion": "0.2.x",
  "templates": { "home": "home.html" },
  "assets": {
    "styles": ["style.css"],
    "scripts": ["theme.js"]
  }
}

3. Add files:

• my-theme/assets/style.css
• my-theme/assets/theme.js
• my-theme/templates/header.html
• my-theme/templates/footer.html
• my-theme/templates/home.html
• my-theme/templates/index.html
• my-theme/templates/single.html
• my-theme/templates/archive.html
• my-theme/templates/taxonomy-category.html
• my-theme/templates/404.html

4. Validate locally:

npm run ci

5. Open PR.

CI

This repo runs GitHub Actions for:

• Theme contract validation
• Security scan (secrets + suspicious patterns)