**Stop vibe-coding scaffolding. Pick a template. Ship.**
4
5
Boilerworks is a catalogue of opinionated, production-ready full-stack templates. One command gets you from zero to a running app with auth, database, background jobs, Docker, and CI — all pre-wired.
6
7
---
8
9
## Install
10
11
```bash
12
pip install boilerworks
13
```
14
15
## Quick Start
16
17
```bash
18
# See all templates
19
boilerworks list
20
21
# Run the setup wizard
22
boilerworks setup
23
24
# Generate your project
25
boilerworks init
26
```
27
28
That's it. `boilerworks init` clones the template, renames everything from `boilerworks` to your project name, and hands you a working repo with a clean git history.
The renderer does case-variant string replacement across every text file:
93
94
- `boilerworks` → `myproject`
95
- `Boilerworks` → `Myproject`
96
- `BOILERWORKS` → `MYPROJECT`
97
98
No Jinja2, no magic. Templates are real repos that boot as-is.
99
100
---
101
102
## Infrastructure (optional)
103
104
If you select a cloud provider during setup, `boilerworks init` also clones [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) — a Terraform repo with full AWS infrastructure (ECS Fargate, RDS, Redis, ALB, Route53, ACM) and GCP/Azure stubs.
105
106
Two topology options:
107
108
- **Standard** — app and ops land in sibling directories
109
- **Omni** — ops lives inside the app repo as `ops/`