BoilerWorks

boilerworks / docs / guide / templates.md
1
# Template Catalogue
2
3
26 production-ready templates across 10 stacks. All ship with real code — no stubs, no TODOs.
4
5
## Full Templates
6
7
Apps with user auth, group permissions, and full admin interface.
8
9
| Template | Backend | Frontend | Auth | Jobs |
10
|----------|---------|----------|------|------|
11
| `django-nextjs` | Django 5 | Next.js 16 (GraphQL/Apollo) | Session | Celery |
12
| `rails-nextjs` | Rails 8 | Next.js 16 (GraphQL/Apollo) | Session | Solid Queue |
13
| `rails-hotwire` | Rails 8 | Hotwire + Tailwind | Session | Solid Queue |
14
| `nestjs-nextjs` | NestJS | Next.js 16 (GraphQL/Apollo) | Session | Bull |
15
| `laravel-vue` | Laravel 12 | Vue 3 (Inertia) | Session | Horizon |
16
| `spring-angular` | Spring Boot | Angular 19 | Session | Spring Scheduler |
17
| `go-nextjs` | Go | Next.js 16 (GraphQL) | Session | — |
18
| `remix-full` | Remix | — | Session | — |
19
| `sveltekit-full` | SvelteKit | — | Session | — |
20
| `phoenix-liveview` | Phoenix | LiveView | Session | Oban |
21
22
### What's in every Full template
23
24
- **User model** with `has_secure_password` / bcrypt
25
- **Group-based permissions** — Pundit / CanCan / custom
26
- **Concerns/mixins**: Auditable, SoftDeletable, ExternalId (UUID), Versionable
27
- **Business models**: Items, Categories, FormDefinitions, FormSubmissions, WorkflowDefinitions, WorkflowInstances
28
- **Admin dashboard** with CRUD for all models
29
- **PostgreSQL 16** (primary) + **Redis 7** (cache + jobs)
30
- **Mailpit** (dev email catcher)
31
- **Docker Compose** (dev) + **Dockerfile** (prod, multi-stage)
32
- **Health check** at `/up` or `/health/`
33
- Tests with real database — never mocked
34
35
---
36
37
## Micro Templates
38
39
API-key auth only. No user management, no frontend. Lean, fast, deployable.
40
41
| Template | Stack | Auth |
42
|----------|-------|------|
43
| `django-micro` | Django 5 REST | API key |
44
| `fastapi-micro` | FastAPI + async | API key |
45
| `nestjs-micro` | NestJS REST | API key |
46
| `rails-micro` | Rails 8 API | API key |
47
| `laravel-micro` | Laravel 12 API | API key |
48
| `spring-micro` | Spring Boot | API key |
49
| `go-micro` | Go + Chi | API key |
50
| `express-micro` | Express + TypeScript | API key |
51
| `phoenix-micro` | Phoenix API | API key |
52
| `rust-micro` | Axum | API key |
53
54
### What's in every Micro template
55
56
- API key auth middleware
57
- Items CRUD endpoint
58
- Health check
59
- PostgreSQL 16 + Redis 7
60
- Docker Compose + Dockerfile
61
- OpenAPI / Swagger docs (where framework supports it)
62
63
---
64
65
## Edge Templates
66
67
Cloudflare-native. No servers, no Docker — deploys to the global edge.
68
69
| Template | Platform | Runtime |
70
|----------|----------|---------|
71
| `sveltekit-edge` | Cloudflare Pages | SvelteKit + adapter-cloudflare |
72
| `remix-edge` | Cloudflare Pages | Remix + adapter-cloudflare |
73
| `nextjs-edge` | Cloudflare Pages | Next.js + @cloudflare/next-on-pages |
74
| `astro-edge` | Cloudflare Pages | Astro + adapter-cloudflare |
75
| `hono-edge` | Cloudflare Workers | Hono |
76
| `worker-edge` | Cloudflare Workers | bare Worker API |
77
78
### What's in every Edge template
79
80
- Cloudflare Workers / Pages deploy config (`wrangler.toml`)
81
- D1 (SQLite) or KV bindings
82
- Local dev with `wrangler dev`
83
- GitHub Actions deploy workflow
84
85
---
86
87
## Ports
88
89
All templates use standardised ports to avoid collisions when running multiple projects:
90
91
| Service | Port |
92
|---------|------|
93
| App | 3000 (frontend) / 8000 (backend API) |
94
| PostgreSQL | 5432 |
95
| Redis | 6379 |
96
| Mailpit (SMTP) | 1025 |
97
| Mailpit (UI) | 8025 |
98
| MinIO (S3) | 9001 |
99

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button