Site Factory

Build single-page websites from markdown content. Works out of the box with a neutral default brand, or optionally use a docs-factory brand kit for custom styling.

Workflow

Step 0: Choose Brand Slug

Ask the user for a brand slug (subdomain) and site name (URL path).

1. Suggest options based on context — e.g. bluewaves, mycompany, or something relevant to the content
2. Validate slug format: must match ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$, 1–63 characters
3. Validate site name format: lowercase letters, numbers, and hyphens only
4. Check availability:

   python3 scripts/site_api.py info {brand} {site-name}
   

   A 404 response means the name is available. Any other response means it's taken.
5. Confirm the chosen slug and site name with the user before proceeding