Monorepo

O Vendee usa Turborepo como build system e Bun 1.3.2 como runtime e gerenciador de pacotes.

Estrutura

vendee-turborepo/
├── apps/
│   ├── app/          # Dashboard SPA (Vite + React)
│   └── docs/         # Documentação (Fumadocs / Next.js 16)
├── packages/
│   ├── supabase/         # @repo/supabase — client + types
│   ├── eslint-config/    # @repo/eslint-config — flat configs
│   └── typescript-config/ # @repo/typescript-config
├── turbo.json
└── package.json

Pipeline Turbo

turbo.json

{
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
    },
    "lint": { "dependsOn": ["^lint"] },
    "check-types": { "dependsOn": ["^check-types"] },
    "dev": { "cache": false, "persistent": true }
  }
}

build e check-types dependem de ^build / ^check-types (builds das dependências primeiro)
dev é persistente e sem cache
lint cascateia pelas dependências

Comandos

bun run dev              # Dev de todos os apps
bun run dev:app          # Apenas apps/app (:5173)
bun run dev:docs         # Apenas apps/docs (:3001)
bun run build            # Build de todos
bun run lint             # Lint (zero warnings)
bun run check-types      # Type-check
bun run format           # Prettier

A porta padrão do apps/app é 5173. Se ela já estiver ocupada (por outro projeto local, por exemplo), rode bunx vite --port 5200 dentro de apps/app — a porta 5200 é a convenção local quando 5173 está em uso.

Type-checking

O script bun run check-types executa tsc -b (build mode com project references), não tsc --noEmit.

Nunca rode tsc --noEmit diretamente para validar o monorepo. Com project references, esse modo não detecta erros cross-package — é um gap silencioso que pode passar no CI e quebrar no build da Vercel. Sempre use bun run check-types.

Variáveis de ambiente globais

Definidas em turbo.json > globalEnv:

VITE_SUPABASE_URL / VITE_SUPABASE_PUBLISHABLE_KEY (legado VITE_SUPABASE_PUBLISHABLE_DEFAULT_KEY) (Vite)
NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY (legado NEXT_PUBLIC_SUPABASE_ANON_KEY) (Next.js)