Menu
Authoritative guide for the monorepo architecture of the react-supabase-boilerplate. Enforces Docker orchestration, Kysely database patterns, and development workflows.
Opinionated backend development standards for Node.js + Express + TypeScript microservices. Covers layered architecture, BaseController pattern, dependency injection, Prisma repositories, Zod validation, unifiedConfig, Sentry error tracking, async safety, and testing discipline.
This skill focuses on backend architecture (Controller/Service/Repository), Prisma interaction, and standardized error/response middleware. Use it when building or modifying backend routes, controllers, or services.
This skill enforces robust, scalable testing methodologies for both the frontend and backend. Use it when writing unit or integration tests, setting up testing frameworks like Vitest, or verifying that features conform to the "Gold Standard".
Authoritative guide for the client-side architecture of the react-supabase-boilerplate. Enforces feature-based modules, Tailwind v4 styling, TanStack ecosystem, and Zustand state patterns.
Authoritative guide for the server-side architecture of the react-supabase-boilerplate. Enforces CSR pattern, Kysely best practices, standardized API responses, and strict middleware usage.
This skill enforces the strict directory structure and file naming conventions of the project. Use this whenever an agent is creating new files or folders to ensure consistency across the client and server.
| version | 1.0.0 |
| name | project-architecture-guide |
| description | Authoritative guide for the monorepo architecture of the react-supabase-boilerplate. Enforces Docker orchestration, Kysely database patterns, and development workflows. |
You are an expert full-stack engineer managing a "Gold Standard" boilerplate. You must follow this project-wide architecture.
/client: React + Vite frontend leveraging TanStack Router and Tailwind v4./server: Node.js Express backend using Controller-Service-Repository pattern./migrations: SQL/TypeScript migrations for database schema management.docker-compose.yml: Orchestrates PostgreSQL, API, and Client.Manage the stack via root-level npm scripts:
npm run dev: Starts the whole stack.npm run db:migrate: Syncs schemas to the DB.npm run db:generate: Generates TypeScript types from the DB.npm run db:seed: Populates test data..where('deletedAt', 'is', null)).server/src/shared/database/db.types.ts.type(scope): description..env.example as a template; never commit .env.tests/[feature]/[name].[unit|integration].test.[ts|tsx]./e2e/tests.npm run test and npm run test:e2e.Follow the Triple-Sync Rule for all API routes requiring body, query, or params:
.schema.ts.validateSchema(schema, 'body' | 'query' | 'params') in the route./** @openapi ... */).