Boilerworks

Production-ready project templates — assembled in seconds.

Boilerworks is a CLI that clones and configures any of 27 opinionated, best-of-breed project templates. Stop re-solving auth, permissions, Docker, CI, and admin panels from scratch. Pick a stack, run boilerworks init, and get straight to your business logic.

pip install boilerworks
boilerworks setup    # interactive wizard → writes boilerworks.yaml
boilerworks init     # clone + configure the template
cd my-project
docker compose up -d # full stack running in seconds

Installation

pip install boilerworks
# or with uv:
uv tool install boilerworks

Requires Python 3.12+.

Quick Start

1. Run the setup wizard

boilerworks setup

Answer 13 questions about your project (name, template, cloud, compliance, etc.) and a boilerworks.yaml manifest is written to the current directory.

2. Generate the project

boilerworks init

Boilerworks clones the selected template, replaces all boilerworks references with your project name, and runs git init to give you a clean starting commit.

3. Start developing

cd my-project
docker compose up -d
# Visit http://localhost:3000

One command. Full stack. No manual setup.

Template Catalogue

27 templates across three sizes:

Full Templates (16)

Micro Templates (6)

Edge Templates (5)

Commands

boilerworks --help              # show all commands
boilerworks list                # show all 27 templates
boilerworks list --size micro   # filter by size
boilerworks list --language python  # filter by language
boilerworks list --json         # machine-readable output (for scripts/agents)
boilerworks info django-nextjs  # full details for one template + its GitHub URL
boilerworks setup               # interactive wizard
boilerworks init                # generate project from boilerworks.yaml
boilerworks init --dry-run      # preview what would happen
boilerworks init --manifest ./path/to/boilerworks.yaml
boilerworks init --output /path/to/output

boilerworks.yaml

The manifest file describes your project. Generated by boilerworks setup, editable by hand.

project: my-app
family: django-nextjs
size: full
topology: standard
cloud: aws
ops: true
region: us-east-1
domain: myapp.com
mobile: false
web_presence: false
compliance:
  - soc2
services:
  email: ses
  cache: redis
data:
  database: postgres
  migrations: true
  seed_data: true
testing:
  e2e: playwright
  unit: true
  integration: true

See boilerworks.yaml.example for a fully annotated version.

MCP Server

Boilerworks ships an MCP server so AI agents can browse the catalogue, build manifests, and scaffold projects as tools. The mcp dependency is an optional extra:

pip install 'boilerworks[mcp]'
boilerworks-mcp                 # stdio MCP server

Register it with Claude Code:

claude mcp add boilerworks -- boilerworks-mcp

Tools exposed: list_templates, get_template, search_templates, create_manifest, validate_manifest, dry_run, init_project.

Claude Code Skill

skill/skill.md is a Claude Code skill that teaches an agent the template catalogue, the boilerworks.yaml schema, and the conventions inside generated projects. Its catalogue tables are generated from boilerworks/data/templates.yaml by scripts/gen_skill_catalogue.py, and a test keeps them in sync.

What Every Template Includes

Every Boilerworks Full template ships with:

• Auth — session-based (httpOnly cookies), bcrypt passwords
• Permissions — group-based, per-operation, checked at every endpoint
• Background jobs — Redis-backed queue, retries, dead-letter handling
• Email — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
• Admin — authenticated management interface with CRUD for all models
• Docker Compose — one command to boot the full stack
• CI/CD — GitHub Actions: lint, test, build, audit
• AI agent shims — CLAUDE.md, AGENTS.md, bootstrap.md

Infrastructure

Pair any template with boilerworks-opscode for production Terraform:

• AWS — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
• GCP / Azure — structured stubs ready for expansion

Select a cloud in boilerworks setup and boilerworks init will clone and configure the ops repo alongside your app.

Contributing

See CONTRIBUTING.md for the development process.

Issues and PRs welcome at github.com/ConflictHQ/boilerworks.

Links

• Documentation: boilerworks.dev
• Product: boilerworks.ai
• Templates: github.com/ConflictHQ

Boilerworks is a CONFLICT brand. CONFLICT is a registered trademark of CONFLICT LLC.