Files
tsysstaticsites/AGENTS.md
Charles N Wyble 87feb5e3b5 feat: initialize Grav multi-site project
- Add AGENTS.md with project requirements and site inventory
- Add JOURNAL.md for project tracking
- Add etc-hosts-entries.txt for local testing (22 domains)
- Add setup.php for Grav multi-site routing configuration

This project migrates 21 mdbook sites to a single Grav multi-site
installation. Each site will have its own environment directory under
user/env/{fqdn}/ with independent config, pages, and themes.

Development runs in Docker on port 12000 (container: tsysstatic-dev-grav).
Production target: Cloudron Grav app at staticsites.turnsys.com.

🤖 Generated with [Crush](https://crush.cbhops.com)

Assisted-by: GLM-5 via Crush <crush@charm.land>
2026-03-02 16:04:09 -05:00

1.9 KiB

TSYS Static Sites - Grav Multi-Site Project

Requirements

Infrastructure

  • Grav CMS multi-site installation for hosting static content
  • Currently migrating from mdbook-based sites
  • Target production: Cloudron LAMP app at staticsites.turnsys.com
  • Development: Docker container on port 12000, named with prefix tsysstatic-dev-

Source Content

  • 21 mdbook repositories in /home/charles/Projects/tsysstatic/
  • Directory name = FQDN for the site
  • All sites use standard mdbook structure (book.toml, src/, SUMMARY.md)

Multi-Site Strategy

  • Single Grav installation hosting multiple domains
  • Each site can have its own git repository for content (per-site repos preferred)
  • Use Grav's environment-based multi-site feature (user/env/{fqdn}/)
  • Domain-based routing via setup.php

Sites to Migrate

  1. governance.turnsys.com (substantial content - governance docs)
  2. plan.ap4ap.org
  3. plan.ezeda.org
  4. plan.afabn.org
  5. plan.ezpodstack.org
  6. plan.hfnoc.net
  7. plan.knownelement.com (substantial content - KNEL docs)
  8. plan.meetmorse.com
  9. plan.merchantsofhope.org
  10. plan.rackrental.net
  11. plan.redwfo.com
  12. plan.rwscp.net
  13. plan.sidedoorgroup.org
  14. plan.sol-calc.com
  15. plan.suborbital-systems.com (has chapter content)
  16. plan.teamrental.net
  17. plan.thecampustradingcompany.com
  18. plan.thepeernet.com
  19. plan.turnsys.com
  20. plan.yourdreamnamehere.com
  21. startinglineproductions.com-bizopprodplan (substantial content - STLP plans)

Development Workflow

  1. Local Docker container for development/testing
  2. /etc/hosts entries for local domain testing
  3. Git repository for Grav configuration and content
  4. Sync to Cloudron Grav instance for production

Technical Constraints

  • Use only: docker, git, and unix utilities on host
  • No AI/ML tools or language servers for file manipulation
  • Container naming: tsysstatic-dev-* prefix
  • Port: 12000