new-project-starter

A production-ready monorepo starter generator based on the ArchonHQ project shape, but generalized for new products.

Included Stack

• SvelteKit frontend scaffold
• shadcn-svelte-ready component setup
• Go backend scaffold
• Docker Compose local stack with Postgres
• OpenAPI 3.1 starter contract
• migration tooling wrappers
• GitHub repo bootstrap automation
• .agents and .codex guidance copied into generated projects

Create A Local Project

./scripts/create-project.sh my-project \
  --display-name "My Project" \
  --module github.com/your-org/my-project \
  --github-owner your-handle

Create, Publish, And Configure A GitHub Repo

BOOTSTRAP_SECRET_OPENAI_API_KEY=your-key \
./scripts/create-and-publish.sh my-project \
  --display-name "My Project" \
  --module github.com/your-org/my-project \
  --github-owner your-handle \
  --public

That flow now:

• generates the repo locally
• commits the scaffold
• creates the GitHub repo
• pushes main
• configures labels
• uploads any BOOTSTRAP_SECRET_* values as repo secrets
• applies branch protection against build-and-check

What The Generated Repo Includes

• monorepo structure for apps, services, packages, integrations, docs, deploy assets, and migrations
• SvelteKit + shadcn-svelte-ready frontend
• Go API with bootstrap login, signed bearer tokens, and protected routes
• migration helpers and an initial SQL schema
• OpenAPI scaffold and roadmap docs
• CI enforcing 80% coverage for Go and frontend tests
• .agents, .codex, .github, and repo hygiene files

Template Repo

The starter itself is published as a GitHub template repository:

• https://github.com/MikeS071/new-project-starter