Loading repository data…
louisbrulenaudet / repository
A concise, AI native and production-grade starter template for full-stack applications using pnpm, Turborepo and Cloudflare Workers for edge-native execution 🚚⛅
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A minimal, production-oriented monorepo starter built on pnpm workspaces with Turborepo, Cloudflare Workers, Hono, React (Vite), Tailwind CSS v4, and TanStack Router/Query. AI-ready, designed for edge deployment, and structured for production projects that scale.
Starter apps today (worker-api, front-app). Prefixes below describe how the repo grows.
monorepo/
├── apps/ # Workers and frontends
│ ├── worker-api/ # REST API gateway
│ └── front-app/ # React SPA (Vite + TanStack)
├── packages/ # Shared @repo/* packages
│ ├── dtos-common/ # Zod wire contracts (api / rpc / queue / webhook)
│ ├── enums-common/ # Shared constrained string values (`as const`)
│ └── typescript-config/ # TypeScript configuration presets
├── make/ # Shared Makefile fragments (see make/README.md)
├── hooks/ # AI agent hooks (not Husky - see hooks/README.md)
├── package.json # Root package configuration
├── pnpm-workspace.yaml # Workspace configuration
├── turbo.json # Turborepo configuration
└── tsconfig.json # Root TypeScript configuration
The monorepo is organized into two main categories: Backend Services and Frontend Applications, plus Shared Packages for common functionality.
flowchart TB
subgraph entry [Public entry]
direction LR
Front["front-* :517x"]
Ext["External providers"]
McpClients["MCP clients"]
end
subgraph publicWorkers [Public Workers]
direction LR
Gateway["worker-api :8700"]
Webhook["webhook-* :876x"]
Mcp["mcp-* :878x"]
end
subgraph privateWorkers [Private Workers]
direction LR
Biz["worker-* (RPC only)"]
Queue["queue-*"]
end
subgraph shared [Shared packages]
direction LR
Enums["@repo/enums-common"]
DTOs["@repo/dtos-common"]
Enums --> DTOs
end
Front --> Gateway
Ext --> Webhook
McpClients --> Mcp
Gateway --> Biz
Webhook --> Biz
Mcp --> Biz
Gateway --> Queue
Webhook --> Queue
Biz --> Queue
Front -.-> shared
publicWorkers -.-> shared
privateWorkers -.-> shared
Selected from shared topics, language and repository description—not editorial ratings.
MoSalem149 /
Email Summarizer AI Agent built with Angular frontend and Node.js/Express backend in TypeScript. The app sends long emails to an OpenAI‑powered agent that returns a concise bullet‑point summary, action items, and key deadlines. Designed as a simple, reusable AI agent pattern for future projects.
55/100 healthCloudflare Workers are organized by runtime role:
worker-api - Public HTTP gateway (Hono): CORS, validation, routing; coordinates internal Workers via RPC.worker-* - Business logic over service-binding RPC only (no public routes in production). May own Drizzle schema under src/db/ and that database’s binding (exclusive owner).queue-* - Queue-only consumers (queue() handler). Messages can be produced by worker-api, worker-*, or webhook-*. Use dual-handler layout when a local HTTP debug path is useful.webhook-* - Public HTTP ingress for external provider callbacks; forward work via RPC or queues.mcp-* - Public HTTP MCP servers; thin tools that call worker-* over RPC.Do not create shared packages/db-* schema packages. Put Drizzle schema under the owning app’s src/db/ and keep one DB binding owner. Other apps reach that data via service-binding RPC (or a queue) - do not attach the same DB binding to multiple apps.
front-app - React SPA (Vite 8, Tailwind v4, TanStack Router/Query) deployed on Cloudflare Workers. Talks to worker-api over HTTP only - never via service bindings.| Task | Location |
|---|---|
| New API route | apps/worker-api/src/routes/<feature>.ts → mount in src/index.ts |
| HTTP Zod schemas | packages/dtos-common/src/api/<feature>.ts |
| RPC / queue / webhook schemas | packages/dtos-common/src/<layer>/<feature>.ts (layer: rpc, queue, or webhook) |
| Shared string value set | packages/enums-common/src/ |
| Worker-local value set | apps/<worker>/src/enums/ |
| DB schema (one owner) | apps/<owner>/src/db/ - never packages/db-* |
| Frontend API client | apps/front-app/src/services/worker-api/<feature>.ts |
| Frontend page + route | apps/front-app/src/pages/ + src/routes/ |
| Local Worker secrets | apps/<worker>/.dev.vars (from .dev.vars.example) |
| Frontend env | apps/front-app/.env.local (from .env.example) |
package.json engines); we recommend fnm for version managementpackageManager field (Corepack recommended)make login / deploy / remote Worker featuresmake install
make login # optional - Cloudflare auth for remote Wrangler features
make prepare # Husky pre-commit hooks
Copy env templates before the first run:
apps/<worker>/.dev.vars.example → .dev.varsapps/front-app/.env.example → .env.localNotes:
make install over raw pnpm install so workspace links stay consistent.pnpm via packageManager in the root package.json.make dev
GET http://localhost:8700/api/v1/healthhttp://localhost:5174Focused work on one package: make dev SCOPE=worker-api (see Scoping).
| Command | Description |
|---|---|
| install | Install and link workspace packages |
| install-frozen | Install with frozen lockfile (CI) |
| login | Login to Cloudflare (repo-pinned Wrangler) |
| update | Update dependencies to latest (rewrites pnpm catalog) |
| check | Lint + format check (no typecheck) |
| ci | Lint + format + check-types (local PR gate) |
| deploy | Deploy all apps/workers (via Turborepo) |
| build | Build all packages and apps (via Turborepo) |
| format | Auto-fix formatting with oxfmt |
| lint | Auto-fix lint issues with oxlint |
| dev | Start all dev servers (via Turborepo) |
| preview | Preview production builds locally (via Turborepo) |
| types | Generate worker-configuration.d.ts in apps |
| check-types | TypeScript across all workers and packages |
| prepare | Install or reinstall Husky git hooks |
| husky-status | Show Husky hooks status |
| skills-update | Refresh locked agent skills (see make/README.md) |
Optional variables on any turbo-backed root target (dev, build, ci, …):
| Variable | Effect | Example |
|---|---|---|
SCOPE | --filter=<package> | make dev SCOPE=worker-api |
FILTER | Raw turbo filter expression | make build FILTER=...front-app... |
AFFECTED | Only changed packages vs base | make ci AFFECTED=1 |
Mnemonic: 87xx = Workers (gateway → business → queue → webhook → MCP → reserve). Frontends use Vite’s 51xx / 41xx.
| Role | Prefix | Local HTTP ports |
|---|---|---|
| HTTP gateway | worker-api | 8700–8709 |
| Business worker (RPC) | worker-* | 8710–8739 |
| Queue-only consumer | queue-* | 8740–8759 |
| Webhook ingress | webhook-* | 8760–8779 |
| MCP server | mcp-* | 8780–8789 |
| Growth reserve | - | 8790–8799 |
| Frontend (Vite) | front-* | 5170–5199 (dev), 4170–4199 (preview) |
| Service | Path | Dev | Preview |
|---|---|---|---|
| worker-api | apps/worker-api/wrangler.jsonc | 8700 | - |
| front-app | apps/front-app/vite.config.ts | 5174 | 4174 |
Notes:
dev.port in wrangler.jsonc and monorepo.devPort in package.json. Use inspector_port: 0.server.port / preview.port with strictPort: true.wrangler dev, but have no public URL in production.-c is HTTP-primary).| Purpose | Prefix | Example |
|---|---|---|
| HTTP gateway | worker-api (sticky) | worker-api |
| Business logic (RPC) | worker- | worker-account |
| Queue-only consumer | queue- | queue-email |
| Webhook ingress | webhook- | webhook-example |
| MCP server | mcp- | mcp-tools |
| Frontend application | front- | front-app |
worker-api): Public HTTP only; validates requests and calls worker-* over RPC.worker-*): RPC-only in production (WorkerEntrypoint); may own Drizzle schema under src/db/ and that database’s binding (exclusive). If they also consume queues, keep this prefix and use the dual-handler layout.queue-*): queue() consumers with no public HTTP in production; may own schema when they are the sole writer for that data.webhook-*): Public HTTP for external callbacks; forward via RPC or queues.mcp-*): Public HTTP MCP transport; thin tools that call worker-* over RPC - never rotate long-lived credentials on this surface.front-*): React + Vite; HTTP to the gateway only - never service bindings.packages/db-* schema packages.There is no generator CLI. Copy the closest sibling under apps/ and wire it into the monorepo:
apps/worker-api (or another closest match) to apps/<prefix-name> (e.g. apps/worker-account).package.json name, wrangler.jsonc name, and any display strings.dev.port / inspector_port: 0 in wrangler.jsonc and monorepo.devPort in package.json.Makefile that includes make/app.mk (see make/README.md).@repo/typescript-config/workers.json (or the matching preset); add .dev.vars.example.make install
make types
Copy wrangler patterns (compatibility_flags, observability, env.staging / env.production) from the existing app - see .cursor/rules/backend/workers-config.mdc.
Prefer scoped make from the repo root:
make dev SCOPE=worker-name
Or use the worker's Makefile:
cd apps/worker-name
make dev
dev script defined in `apps/worker-nam