turbo-template

Better Auth authentication patterns for this monorepo. Use when implementing login, signup, session management, OAuth, auth guards, or working with @repo/auth. Triggers on tasks involving authentication, authorization, sessions, cookies, auth middleware, or user identity.

oRPC contract-first API design for this monorepo. Use when creating API endpoints, defining schemas, implementing controllers, building frontend hooks, or working with @repo/contracts, @orpc/contract, @orpc/server, @orpc/nest, or @orpc/client. Triggers on tasks involving API routes, Zod schemas for contracts, type-safe RPC, or end-to-end type safety.

AWS infrastructure patterns for this monorepo. Infrastructure is managed in a separate turbo-infrastructure repo via Terraform modules. This app repo only contains deployment workflows (GitHub Actions) and a docker-compose for staging. Use when deploying to AWS, configuring CI/CD, or setting up GitHub environment variables.

CI/CD pipeline patterns for this monorepo using GitHub Actions. Staging deploys to EC2 via Docker Compose + Nginx. Production deploys to ECS Fargate. Infrastructure is managed separately via Terraform in the turbo-infrastructure repo.

Security patterns and hardening practices for this monorepo. Use when implementing authentication, configuring CORS, validating input, handling secrets, securing API endpoints, or reviewing code for vulnerabilities. Triggers on tasks involving security, auth guards, env validation, CORS, CSP, rate limiting, or OWASP compliance.

Docker containerization and deployment patterns for this Turborepo monorepo. Use when writing Dockerfiles, configuring docker-compose, optimizing images, or preparing production builds. Triggers on tasks involving containers, multi-stage builds, turbo prune, image optimization, or local orchestration.

Drizzle ORM with PostgreSQL patterns for this monorepo. Use when creating database tables, writing queries, defining relations, running migrations, or working with @repo/db. Triggers on tasks involving database schema, SQL queries, table definitions, foreign keys, indexes, or the db package.

Error handling, logging, and observability patterns for this monorepo. Use when implementing exception filters, error boundaries, structured logging, CloudWatch integration, or health checks. Triggers on tasks involving error responses, exception handling, log formats, monitoring, health endpoints, or observability.

Next.js 16 App Router conventions for this monorepo. Use when creating pages, layouts, route handlers, server components, client components, or working in apps/web/. Triggers on tasks involving routing, SSR, RSC, server actions, metadata, fonts, or Next.js configuration.

Tailwind CSS v4 and shadcn/ui component patterns for this monorepo. Use when styling components, adding shadcn UI components, configuring themes, or working with apps/web/ styling. Triggers on tasks involving CSS, classNames, dark mode, component library, Toaster, ThemeProvider, or responsive design.

TanStack Query integration with oRPC for this monorepo. Use when creating query hooks, mutations, prefetching data, managing cache, or working with services/tanstack-query/ or services/orpc/. Triggers on tasks involving data fetching, cache invalidation, SSR prefetching, hydration, or stale time configuration.

Testing patterns for this Turborepo monorepo. Use when writing unit tests, E2E tests, creating test data factories, mocking dependencies, or configuring Jest. Triggers on tasks involving test files, spec files, coverage, assertions, test utilities, or test configuration.

Turborepo monorepo structure and pnpm workspace conventions. Use when adding packages, configuring build pipelines, managing dependencies, running scripts, or working with the monorepo root config. Triggers on tasks involving workspace setup, package management, turbo.json, pnpm-workspace.yaml, or cross-package dependencies.