turbo-template-laravel

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 EC2 via ALB + ASG rolling instance refresh. Infrastructure is managed separately via Terraform in the turbo-infrastructure repo.

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.

Eloquent ORM + MySQL migration patterns for this monorepo. Use when defining models, writing migrations, setting up relationships, or seeding data in apps/laravel/. Triggers on tasks involving database tables, foreign keys, indexes, model factories, or seeders.

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.

Laravel 12 / PHP 8.4 backend conventions for this monorepo. Use when adding controllers, Form Requests, Resources, middleware, routes, or any work inside apps/laravel/. Triggers on tasks involving PHP, Artisan commands, service providers, or the Laravel app directory.

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.

Orval code generation + TanStack Query patterns for the @repo/api-client package. Use when regenerating TypeScript hooks from openapi.json, implementing the custom fetcher, or consuming generated hooks in apps/web. Triggers on tasks involving orval.config.ts, api-client generation, customFetcher, TanStack Query hooks from the Laravel API, or @repo/api-client imports.

Pest PHP testing patterns for this monorepo. Use when writing tests for Laravel controllers, services, models, or authentication flows. Triggers on tasks involving Pest, PHPUnit, feature tests, unit tests, HTTP assertions, or test factories.

PHP-FPM + Nginx deployment patterns for the Laravel container in this monorepo. Use when modifying the Dockerfile, nginx.conf, supervisord.conf, entrypoint.sh, or Docker Compose files. Triggers on tasks involving containerization, process management, static file serving, or production deployment configuration.

Laravel Sanctum dual-mode authentication for this monorepo. Use when implementing login, session management, PAT tokens, CSRF cookie flow, or auth middleware. Triggers on tasks involving authentication, authorization, Sanctum, SPA cookies, Bearer tokens, or user identity.

Scribe OpenAPI generation patterns for the Laravel API. Use when adding or updating API documentation annotations, regenerating openapi.json, or configuring Scribe. Triggers on tasks involving @group, @bodyParam, @response, @authenticated, openapi.json updates, or the api-client drift gate.

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.

Testing patterns for this Turborepo monorepo. Use when writing unit tests, E2E tests, creating test data factories, mocking dependencies, or configuring Pest/Vitest. 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.