Parchment Worlds

Working-name local-first procedural world map generator for tabletop RPG worldbuilding.

Start points:

• docs/prd/worldbuilder-map-generator-prd.md for MVP product decisions.
• refs/README.md for the Agent-Academy project-memory harness.
• refs/agents.yaml for agent operating instructions.

MVP App

Launch on Windows:

.\launch.ps1

or double-click launch.bat.

Manual start:

npm install
npm run dev

Then open http://127.0.0.1:5173/.

Validation:

npm run validate
npm run build

Hosted deploy trigger:

.\deploy.ps1

The deploy helper validates, builds, requires a clean committed tree, then pushes main so GitHub Actions can upload the site using repository secrets.

Generation benchmark:

npm run benchmark:generation

Desktop packaging:

npm run tauri:build

The generator records per-phase diagnostics on generated projects so current runtime hotspots can be inspected from the app summary and benchmark output.

Do not store secrets or machine-local credentials in this repository.