Quick Start

Get a working project in under 5 minutes.

1. Install

pip install boilerworks

2. Pick a template

boilerworks list

This shows all 26 templates with size, language, and description.

boilerworks list --size full      # only Full templates
boilerworks list --language python  # only Python templates

3. Run the wizard

boilerworks setup

The wizard asks 13 questions:

• Project name — slug format (e.g. my-app)
• Template size — Full / Micro / Edge
• Template family — filtered list based on size
• Topology — standard (separate repos) or omni (monorepo)
• Cloud provider — aws / gcp / azure / none
• Infrastructure — include boilerworks-opscode? (yes/no, if cloud selected)
• Region — e.g. us-east-1
• Domain — e.g. myapp.com
• Mobile — include mobile template? (Full only)
• Web presence — include marketing site? (Full only)
• Compliance — SOC2 / HIPAA / PCI-DSS / GDPR
• Email provider — SES / SendGrid / Mailgun
• E2E testing — Playwright / Cypress

Writes boilerworks.yaml to the current directory.

4. Generate

boilerworks init

This:

• Clones the template from ConflictHQ/boilerworks-{family}
• Removes .git/
• Replaces all boilerworks strings with your project name (case-variant)
• Renames any files/directories containing boilerworks
• If cloud + ops selected: clones boilerworks-opscode and configures it
• Runs git init + initial commit

5. Boot it

cd my-app
docker compose up -d

Visit http://localhost:3000. Your app is running with your project name everywhere.

What you get

Every Full template ships with:

• User auth (login, logout, session management)
• Group-based permissions
• Items + Categories CRUD
• Form definitions + submissions
• Workflow definitions + instances
• Admin dashboard
• Background jobs
• PostgreSQL 16 + Redis 7
• Docker Compose (dev) + Dockerfile (prod)
• Health check endpoint
• RSpec / pytest tests
• CI pipeline

Dry run first: Not sure what will happen? Run boilerworks init --dry-run to see the full plan without touching the filesystem.

Z e6649cbaa6a1a91f4143831