Quickstart

Scaffold a Genesis project and get it running in under 5 minutes.

1. Scaffold your project

Create a new project with genesis-start. It copies the template, stamps your project metadata, and strips the modules you don't need:

bunx @olwiba/genesis-start

You'll be asked for a project name and which optional modules to keep: payments, AI chat, background jobs, uploads, REST API, and MCP server are all strippable at scaffold time.

2. Install and bootstrap

cd my-app
bun install
bun run bootstrap

Bootstrap prepares your environment file, generates the Prisma client, and pushes the schema to a local SQLite database. Zero configuration required for development.

3. Start the dev server

bun run dev

Open http://localhost:3000. You have a running app with a marketing site, auth, an onboarding flow, a dashboard, and an admin area.

4. Create your admin user

Sign up through the app, then promote your account:

bun run db:seed

The seed script creates demo data and an admin user. Sign in and visit /admin to see user management and feature flags.

What's next?

  • Read the Authentication guide for sessions, roles, and route guards
  • Edit src/project.config.ts to set your theme and project identity
  • Replace the marketing copy in src/config/marketing-pages.ts with your own