Repository Map

Repository map

Top-level ownership

Path	Owner and purpose	Published?
cli/	Praxis Flow CLI, generator, manifests, UI artifacts, and tests	npm package praxiflow
web/	Public Next.js product website	Vercel application
docs/	Human/agent documentation source and design records	Rendered to GitHub Wiki
scripts/	Repository documentation tooling	Repository only
.github/workflows/	CI, UI matrix, Wiki publication	GitHub Actions
package.json	Private npm workspace and shared commands	Not published

CLI source map

Path	Responsibility
cli/src/index.ts	Executable entry point and top-level error boundary
cli/src/cli/command.ts	Argument grammar and ParsedCommand
cli/src/cli/run.ts	Command routing
cli/src/workflow/runCreate.ts	Interactive questionnaire and create orchestration
cli/src/workflow/answers.ts	Convert standard/Pro answers into configuration
cli/src/config/schema.ts	Configuration types, defaults, migrations, validation
cli/src/config/pro.ts	Pro stacks, capabilities, implication closure
cli/src/config/load.ts	Read configuration JSON
cli/src/config/resolver.ts	Convert validated configuration to ordered module IDs
cli/src/composer/manifest.ts	Manifest type system
cli/src/composer/compose.ts	Atomic overlays, patches, packages, env, and token replacement
cli/src/generator/generate.ts	Resolve, compose, optionally install and initialize Git
cli/src/ui/	UI catalog, gallery server, browser/terminal selection
cli/templates/	Bundled manifest modules and generated UI artifacts
cli/scripts/ui/	Authoring/generation pipeline for the 40 UI styles
cli/tests/	Unit, integration, generation matrix, accessibility, and package tests

Template naming families

Prefix	Examples	Role
base.	base.workspace	Root structure for fullstack outputs
frontend.	frontend.next, frontend.vue	Framework scaffold
styling.	styling.tailwind-shadcn	Cross-framework styling primitives
ui.	ui.apple, ui.warp	Styled landing page replacement
backend.	backend.express	Standard backend scaffold
database.	database.postgres	Database client/schema integration
auth.	auth.clerk	Authentication integration
cache.	cache.redis	Cache client and lifecycle integration
deployment.	deployment.docker	Deployment artifacts
pro.	pro.core, pro.django, pro.gin	Pro base and stack
pro.capability.	pro.capability.kafka	Optional Pro implementation capability
pro.terraform.	pro.terraform.aws	Cloud-specific infrastructure

Files generated by tooling

The contents of cli/templates/ui.<style>/ and cli/templates/ui.catalog/ are generated from design sources and scripts. Edit the canonical sources and renderer under cli/scripts/ui/; then run npm --workspace cli run ui:generate and ui:previews. ui:verify proves committed artifacts are current.

Generated application directories are disposable test fixtures unless a test explicitly preserves them for failure diagnosis. Do not treat cli/dist/ as source; it is rebuilt from TypeScript.