BoilerWorks
docs: update README — all 26 templates done, correct versions, ops section
Commit
c5c508547343a65d1de6972492df18c131ca6240e8429942bf0dfa861332a3c4
Parent
e6d6826f83346b1…
1 file changed
+48
-40
+48
-40
| --- README.md | ||
| +++ README.md | ||
| @@ -2,11 +2,11 @@ | ||
| 2 | 2 | |
| 3 | 3 | **Production-ready project templates — assembled in seconds.** |
| 4 | 4 | |
| 5 | 5 | Boilerworks is a CLI that clones and configures any of 26 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. |
| 6 | 6 | |
| 7 | -``` | |
| 7 | +```bash | |
| 8 | 8 | pip install boilerworks |
| 9 | 9 | boilerworks setup # interactive wizard → writes boilerworks.yaml |
| 10 | 10 | boilerworks init # clone + configure the template |
| 11 | 11 | cd my-project |
| 12 | 12 | docker compose up -d # full stack running in seconds |
| @@ -66,48 +66,48 @@ | ||
| 66 | 66 | | **Micro** | API services | API-key auth | VPS, containers | |
| 67 | 67 | | **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages | |
| 68 | 68 | |
| 69 | 69 | ### Full Templates (15) |
| 70 | 70 | |
| 71 | -| Name | Backend | Frontend | Status | | |
| 72 | -|------|---------|----------|--------| | |
| 73 | -| django-nextjs | Django 5 | Next.js 16 | ✅ Done | | |
| 74 | -| nestjs-nextjs | NestJS 11 | Next.js 16 | ✅ Done | | |
| 75 | -| django-htmx | Django 5 | HTMX + Alpine.js | 🔨 Building | | |
| 76 | -| saleor-nextjs | Saleor (Django) | Next.js 16 | 🔨 Building | | |
| 77 | -| rails-hotwire | Rails 8 | Hotwire | 🔨 Building | | |
| 78 | -| laravel-vue | Laravel 11 | Inertia + Vue 3 | 🔨 Building | | |
| 79 | -| fastapi-nextjs | FastAPI | Next.js 16 | 🔨 Building | | |
| 80 | -| fastapi-htmx | FastAPI | HTMX + Alpine.js | 📋 Planned | | |
| 81 | -| spring-angular | Spring Boot 3 | Angular 19 | 📋 Planned | | |
| 82 | -| go-htmx | Go + Chi/Echo | HTMX + Templ | 📋 Planned | | |
| 83 | -| rails-nextjs | Rails 8 | Next.js 16 | 📋 Planned | | |
| 84 | -| phoenix-liveview | Phoenix 1.7 | LiveView | 📋 Planned | | |
| 85 | -| spring-nextjs | Spring Boot 3 | Next.js 16 | 📋 Planned | | |
| 86 | -| go-nextjs | Go + Chi/Echo | Next.js 16 | 📋 Planned | | |
| 87 | -| laravel-livewire | Laravel 11 | Livewire 3 | 📋 Planned | | |
| 71 | +| Name | Backend | Frontend | | |
| 72 | +|------|---------|----------| | |
| 73 | +| [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 | | |
| 74 | +| [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 | | |
| 75 | +| [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind | | |
| 76 | +| [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 | | |
| 77 | +| [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 | | |
| 78 | +| [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 | | |
| 79 | +| [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView | | |
| 80 | +| [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 | | |
| 81 | +| [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js | | |
| 82 | +| [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 | | |
| 83 | +| [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 | | |
| 84 | +| [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 | | |
| 85 | +| [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ | | |
| 86 | +| [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js | | |
| 87 | +| [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 | | |
| 88 | 88 | |
| 89 | 89 | ### Micro Templates (6) |
| 90 | 90 | |
| 91 | -| Name | Backend | Status | | |
| 92 | -|------|---------|--------| | |
| 93 | -| fastapi-micro | FastAPI | 🔨 Building | | |
| 94 | -| django-micro | Django 5 (DRF/Ninja) | 📋 Planned | | |
| 95 | -| nestjs-micro | NestJS 11 | 📋 Planned | | |
| 96 | -| go-micro | Go + Chi/Echo | 📋 Planned | | |
| 97 | -| cherrypy-micro | CherryPy | 📋 Planned | | |
| 98 | -| rust-micro | Axum (Rust) | 📋 Planned | | |
| 91 | +| Name | Backend | | |
| 92 | +|------|---------| | |
| 93 | +| [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) | | |
| 94 | +| [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI | | |
| 95 | +| [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 | | |
| 96 | +| [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi | | |
| 97 | +| [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) | | |
| 98 | +| [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy | | |
| 99 | 99 | |
| 100 | 100 | ### Edge Templates (5) |
| 101 | 101 | |
| 102 | -| Name | Framework | Status | | |
| 103 | -|------|-----------|--------| | |
| 104 | -| hono-micro | Hono | 📋 Planned | | |
| 105 | -| sveltekit-full | SvelteKit | 📋 Planned | | |
| 106 | -| nuxt-full | Nuxt 4 | 📋 Planned | | |
| 107 | -| remix-full | Remix | 📋 Planned | | |
| 108 | -| astro-site | Astro | 📋 Planned | | |
| 102 | +| Name | Framework | | |
| 103 | +|------|-----------| | |
| 104 | +| [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit | | |
| 105 | +| [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix | | |
| 106 | +| [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) | | |
| 107 | +| [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 | | |
| 108 | +| [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro | | |
| 109 | 109 | |
| 110 | 110 | --- |
| 111 | 111 | |
| 112 | 112 | ## Commands |
| 113 | 113 | |
| @@ -114,17 +114,15 @@ | ||
| 114 | 114 | ```bash |
| 115 | 115 | boilerworks --help # show all commands |
| 116 | 116 | boilerworks list # show all 26 templates |
| 117 | 117 | boilerworks list --size micro # filter by size |
| 118 | 118 | boilerworks list --language python # filter by language |
| 119 | -boilerworks list --status done # filter by status | |
| 120 | 119 | boilerworks setup # interactive wizard |
| 121 | 120 | boilerworks init # generate project from boilerworks.yaml |
| 122 | 121 | boilerworks init --dry-run # preview what would happen |
| 123 | 122 | boilerworks init --manifest ./path/to/boilerworks.yaml |
| 124 | 123 | boilerworks init --output /path/to/output |
| 125 | -boilerworks bootstrap # show infrastructure plan (v2) | |
| 126 | 124 | ``` |
| 127 | 125 | |
| 128 | 126 | --- |
| 129 | 127 | |
| 130 | 128 | ## boilerworks.yaml |
| @@ -135,19 +133,19 @@ | ||
| 135 | 133 | project: my-app |
| 136 | 134 | family: django-nextjs |
| 137 | 135 | size: full |
| 138 | 136 | topology: standard |
| 139 | 137 | cloud: aws |
| 138 | +ops: true | |
| 140 | 139 | region: us-east-1 |
| 141 | 140 | domain: myapp.com |
| 142 | 141 | mobile: false |
| 143 | 142 | web_presence: false |
| 144 | 143 | compliance: |
| 145 | 144 | - soc2 |
| 146 | 145 | services: |
| 147 | 146 | email: ses |
| 148 | - storage: s3 | |
| 149 | 147 | cache: redis |
| 150 | 148 | data: |
| 151 | 149 | database: postgres |
| 152 | 150 | migrations: true |
| 153 | 151 | seed_data: true |
| @@ -163,21 +161,30 @@ | ||
| 163 | 161 | |
| 164 | 162 | ## What Every Template Includes |
| 165 | 163 | |
| 166 | 164 | Every Boilerworks Full template ships with: |
| 167 | 165 | |
| 168 | -- **Auth** — session-based (httpOnly cookies), SHA256-hashed tokens | |
| 166 | +- **Auth** — session-based (httpOnly cookies), bcrypt passwords | |
| 169 | 167 | - **Permissions** — group-based, per-operation, checked at every endpoint |
| 170 | 168 | - **Background jobs** — Redis-backed queue, retries, dead-letter handling |
| 171 | -- **File storage** — S3/MinIO with upload validation | |
| 172 | -- **Search** — full-text search engine integration | |
| 173 | 169 | - **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally) |
| 174 | -- **Admin** — authenticated management interface | |
| 170 | +- **Admin** — authenticated management interface with CRUD for all models | |
| 175 | 171 | - **Docker Compose** — one command to boot the full stack |
| 176 | 172 | - **CI/CD** — GitHub Actions: lint, test, build, audit |
| 177 | 173 | - **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md |
| 178 | 174 | |
| 175 | +--- | |
| 176 | + | |
| 177 | +## Infrastructure | |
| 178 | + | |
| 179 | +Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform: | |
| 180 | + | |
| 181 | +- **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager | |
| 182 | +- **GCP / Azure** — structured stubs ready for expansion | |
| 183 | + | |
| 184 | +Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app. | |
| 185 | + | |
| 179 | 186 | --- |
| 180 | 187 | |
| 181 | 188 | ## Contributing |
| 182 | 189 | |
| 183 | 190 | See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process. |
| @@ -187,10 +194,11 @@ | ||
| 187 | 194 | --- |
| 188 | 195 | |
| 189 | 196 | ## Links |
| 190 | 197 | |
| 191 | 198 | - Documentation: [boilerworks.dev](https://boilerworks.dev) |
| 199 | +- Product: [boilerworks.ai](https://boilerworks.ai) | |
| 192 | 200 | - Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ) |
| 193 | 201 | |
| 194 | 202 | --- |
| 195 | 203 | |
| 196 | 204 | Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC. |
| 197 | 205 |
| --- README.md | |
| +++ README.md | |
| @@ -2,11 +2,11 @@ | |
| 2 | |
| 3 | **Production-ready project templates — assembled in seconds.** |
| 4 | |
| 5 | Boilerworks is a CLI that clones and configures any of 26 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. |
| 6 | |
| 7 | ``` |
| 8 | pip install boilerworks |
| 9 | boilerworks setup # interactive wizard → writes boilerworks.yaml |
| 10 | boilerworks init # clone + configure the template |
| 11 | cd my-project |
| 12 | docker compose up -d # full stack running in seconds |
| @@ -66,48 +66,48 @@ | |
| 66 | | **Micro** | API services | API-key auth | VPS, containers | |
| 67 | | **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages | |
| 68 | |
| 69 | ### Full Templates (15) |
| 70 | |
| 71 | | Name | Backend | Frontend | Status | |
| 72 | |------|---------|----------|--------| |
| 73 | | django-nextjs | Django 5 | Next.js 16 | ✅ Done | |
| 74 | | nestjs-nextjs | NestJS 11 | Next.js 16 | ✅ Done | |
| 75 | | django-htmx | Django 5 | HTMX + Alpine.js | 🔨 Building | |
| 76 | | saleor-nextjs | Saleor (Django) | Next.js 16 | 🔨 Building | |
| 77 | | rails-hotwire | Rails 8 | Hotwire | 🔨 Building | |
| 78 | | laravel-vue | Laravel 11 | Inertia + Vue 3 | 🔨 Building | |
| 79 | | fastapi-nextjs | FastAPI | Next.js 16 | 🔨 Building | |
| 80 | | fastapi-htmx | FastAPI | HTMX + Alpine.js | 📋 Planned | |
| 81 | | spring-angular | Spring Boot 3 | Angular 19 | 📋 Planned | |
| 82 | | go-htmx | Go + Chi/Echo | HTMX + Templ | 📋 Planned | |
| 83 | | rails-nextjs | Rails 8 | Next.js 16 | 📋 Planned | |
| 84 | | phoenix-liveview | Phoenix 1.7 | LiveView | 📋 Planned | |
| 85 | | spring-nextjs | Spring Boot 3 | Next.js 16 | 📋 Planned | |
| 86 | | go-nextjs | Go + Chi/Echo | Next.js 16 | 📋 Planned | |
| 87 | | laravel-livewire | Laravel 11 | Livewire 3 | 📋 Planned | |
| 88 | |
| 89 | ### Micro Templates (6) |
| 90 | |
| 91 | | Name | Backend | Status | |
| 92 | |------|---------|--------| |
| 93 | | fastapi-micro | FastAPI | 🔨 Building | |
| 94 | | django-micro | Django 5 (DRF/Ninja) | 📋 Planned | |
| 95 | | nestjs-micro | NestJS 11 | 📋 Planned | |
| 96 | | go-micro | Go + Chi/Echo | 📋 Planned | |
| 97 | | cherrypy-micro | CherryPy | 📋 Planned | |
| 98 | | rust-micro | Axum (Rust) | 📋 Planned | |
| 99 | |
| 100 | ### Edge Templates (5) |
| 101 | |
| 102 | | Name | Framework | Status | |
| 103 | |------|-----------|--------| |
| 104 | | hono-micro | Hono | 📋 Planned | |
| 105 | | sveltekit-full | SvelteKit | 📋 Planned | |
| 106 | | nuxt-full | Nuxt 4 | 📋 Planned | |
| 107 | | remix-full | Remix | 📋 Planned | |
| 108 | | astro-site | Astro | 📋 Planned | |
| 109 | |
| 110 | --- |
| 111 | |
| 112 | ## Commands |
| 113 | |
| @@ -114,17 +114,15 @@ | |
| 114 | ```bash |
| 115 | boilerworks --help # show all commands |
| 116 | boilerworks list # show all 26 templates |
| 117 | boilerworks list --size micro # filter by size |
| 118 | boilerworks list --language python # filter by language |
| 119 | boilerworks list --status done # filter by status |
| 120 | boilerworks setup # interactive wizard |
| 121 | boilerworks init # generate project from boilerworks.yaml |
| 122 | boilerworks init --dry-run # preview what would happen |
| 123 | boilerworks init --manifest ./path/to/boilerworks.yaml |
| 124 | boilerworks init --output /path/to/output |
| 125 | boilerworks bootstrap # show infrastructure plan (v2) |
| 126 | ``` |
| 127 | |
| 128 | --- |
| 129 | |
| 130 | ## boilerworks.yaml |
| @@ -135,19 +133,19 @@ | |
| 135 | project: my-app |
| 136 | family: django-nextjs |
| 137 | size: full |
| 138 | topology: standard |
| 139 | cloud: aws |
| 140 | region: us-east-1 |
| 141 | domain: myapp.com |
| 142 | mobile: false |
| 143 | web_presence: false |
| 144 | compliance: |
| 145 | - soc2 |
| 146 | services: |
| 147 | email: ses |
| 148 | storage: s3 |
| 149 | cache: redis |
| 150 | data: |
| 151 | database: postgres |
| 152 | migrations: true |
| 153 | seed_data: true |
| @@ -163,21 +161,30 @@ | |
| 163 | |
| 164 | ## What Every Template Includes |
| 165 | |
| 166 | Every Boilerworks Full template ships with: |
| 167 | |
| 168 | - **Auth** — session-based (httpOnly cookies), SHA256-hashed tokens |
| 169 | - **Permissions** — group-based, per-operation, checked at every endpoint |
| 170 | - **Background jobs** — Redis-backed queue, retries, dead-letter handling |
| 171 | - **File storage** — S3/MinIO with upload validation |
| 172 | - **Search** — full-text search engine integration |
| 173 | - **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally) |
| 174 | - **Admin** — authenticated management interface |
| 175 | - **Docker Compose** — one command to boot the full stack |
| 176 | - **CI/CD** — GitHub Actions: lint, test, build, audit |
| 177 | - **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md |
| 178 | |
| 179 | --- |
| 180 | |
| 181 | ## Contributing |
| 182 | |
| 183 | See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process. |
| @@ -187,10 +194,11 @@ | |
| 187 | --- |
| 188 | |
| 189 | ## Links |
| 190 | |
| 191 | - Documentation: [boilerworks.dev](https://boilerworks.dev) |
| 192 | - Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ) |
| 193 | |
| 194 | --- |
| 195 | |
| 196 | Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC. |
| 197 |
| --- README.md | |
| +++ README.md | |
| @@ -2,11 +2,11 @@ | |
| 2 | |
| 3 | **Production-ready project templates — assembled in seconds.** |
| 4 | |
| 5 | Boilerworks is a CLI that clones and configures any of 26 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. |
| 6 | |
| 7 | ```bash |
| 8 | pip install boilerworks |
| 9 | boilerworks setup # interactive wizard → writes boilerworks.yaml |
| 10 | boilerworks init # clone + configure the template |
| 11 | cd my-project |
| 12 | docker compose up -d # full stack running in seconds |
| @@ -66,48 +66,48 @@ | |
| 66 | | **Micro** | API services | API-key auth | VPS, containers | |
| 67 | | **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages | |
| 68 | |
| 69 | ### Full Templates (15) |
| 70 | |
| 71 | | Name | Backend | Frontend | |
| 72 | |------|---------|----------| |
| 73 | | [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 | |
| 74 | | [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 | |
| 75 | | [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind | |
| 76 | | [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 | |
| 77 | | [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 | |
| 78 | | [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 | |
| 79 | | [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView | |
| 80 | | [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 | |
| 81 | | [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js | |
| 82 | | [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 | |
| 83 | | [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 | |
| 84 | | [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 | |
| 85 | | [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ | |
| 86 | | [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js | |
| 87 | | [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 | |
| 88 | |
| 89 | ### Micro Templates (6) |
| 90 | |
| 91 | | Name | Backend | |
| 92 | |------|---------| |
| 93 | | [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) | |
| 94 | | [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI | |
| 95 | | [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 | |
| 96 | | [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi | |
| 97 | | [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) | |
| 98 | | [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy | |
| 99 | |
| 100 | ### Edge Templates (5) |
| 101 | |
| 102 | | Name | Framework | |
| 103 | |------|-----------| |
| 104 | | [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit | |
| 105 | | [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix | |
| 106 | | [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) | |
| 107 | | [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 | |
| 108 | | [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro | |
| 109 | |
| 110 | --- |
| 111 | |
| 112 | ## Commands |
| 113 | |
| @@ -114,17 +114,15 @@ | |
| 114 | ```bash |
| 115 | boilerworks --help # show all commands |
| 116 | boilerworks list # show all 26 templates |
| 117 | boilerworks list --size micro # filter by size |
| 118 | boilerworks list --language python # filter by language |
| 119 | boilerworks setup # interactive wizard |
| 120 | boilerworks init # generate project from boilerworks.yaml |
| 121 | boilerworks init --dry-run # preview what would happen |
| 122 | boilerworks init --manifest ./path/to/boilerworks.yaml |
| 123 | boilerworks init --output /path/to/output |
| 124 | ``` |
| 125 | |
| 126 | --- |
| 127 | |
| 128 | ## boilerworks.yaml |
| @@ -135,19 +133,19 @@ | |
| 133 | project: my-app |
| 134 | family: django-nextjs |
| 135 | size: full |
| 136 | topology: standard |
| 137 | cloud: aws |
| 138 | ops: true |
| 139 | region: us-east-1 |
| 140 | domain: myapp.com |
| 141 | mobile: false |
| 142 | web_presence: false |
| 143 | compliance: |
| 144 | - soc2 |
| 145 | services: |
| 146 | email: ses |
| 147 | cache: redis |
| 148 | data: |
| 149 | database: postgres |
| 150 | migrations: true |
| 151 | seed_data: true |
| @@ -163,21 +161,30 @@ | |
| 161 | |
| 162 | ## What Every Template Includes |
| 163 | |
| 164 | Every Boilerworks Full template ships with: |
| 165 | |
| 166 | - **Auth** — session-based (httpOnly cookies), bcrypt passwords |
| 167 | - **Permissions** — group-based, per-operation, checked at every endpoint |
| 168 | - **Background jobs** — Redis-backed queue, retries, dead-letter handling |
| 169 | - **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally) |
| 170 | - **Admin** — authenticated management interface with CRUD for all models |
| 171 | - **Docker Compose** — one command to boot the full stack |
| 172 | - **CI/CD** — GitHub Actions: lint, test, build, audit |
| 173 | - **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md |
| 174 | |
| 175 | --- |
| 176 | |
| 177 | ## Infrastructure |
| 178 | |
| 179 | Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform: |
| 180 | |
| 181 | - **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager |
| 182 | - **GCP / Azure** — structured stubs ready for expansion |
| 183 | |
| 184 | Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app. |
| 185 | |
| 186 | --- |
| 187 | |
| 188 | ## Contributing |
| 189 | |
| 190 | See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process. |
| @@ -187,10 +194,11 @@ | |
| 194 | --- |
| 195 | |
| 196 | ## Links |
| 197 | |
| 198 | - Documentation: [boilerworks.dev](https://boilerworks.dev) |
| 199 | - Product: [boilerworks.ai](https://boilerworks.ai) |
| 200 | - Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ) |
| 201 | |
| 202 | --- |
| 203 | |
| 204 | Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC. |
| 205 |