Files

Giancarlo Buomprisco 7ebff31475 Next.js Supabase V3 (#463 )

Version 3 of the kit:
- Radix UI replaced with Base UI (using the Shadcn UI patterns)
- next-intl replaces react-i18next
- enhanceAction deprecated; usage moved to next-safe-action
- main layout now wrapped with [locale] path segment
- Teams only mode
- Layout updates
- Zod v4
- Next.js 16.2
- Typescript 6
- All other dependencies updated
- Removed deprecated Edge CSRF
- Dynamic Github Action runner

2026-03-24 13:40:38 +08:00

3.1 KiB

Raw Blame History

Makerkit SaaS Starter

Tech Stack

Next.js 16 (App Router) + React 19 + TypeScript
Supabase (Postgres, Auth, Storage)
Tailwind CSS 4 + Shadcn UI
Turborepo monorepo

Monorepo Structure

Directory	Purpose	Details
`apps/web`	Main Next.js app	See `apps/web/AGENTS.md`
`apps/web/supabase`	Database schemas & migrations	See `apps/web/supabase/AGENTS.md`
`apps/e2e`	Playwright E2E tests	See `apps/e2e/AGENTS.md`
`packages/ui`	UI components (@kit/ui)	See `packages/ui/AGENTS.md`
`packages/supabase`	Supabase clients	See `packages/supabase/AGENTS.md`
`packages/next`	Next.js utilities	See `packages/next/AGENTS.md`
`packages/features`	Feature packages	See `packages/features/AGENTS.md`

Next.js: ALWAYS read docs before coding

Before any Next.js work, find and read the relevant doc in apps/web/node_modules/next/dist/docs/. Your training data is outdated — the docs are the source of truth.

Multi-Tenant Architecture

Personal Accounts: auth.users.id = accounts.id
Team Accounts: Shared workspaces with members, roles, permissions
Data links to accounts via account_id foreign key

Essential Commands

pnpm dev                          # Start development
pnpm supabase:web:start           # Start local Supabase
pnpm supabase:web:reset           # Reset database
pnpm supabase:web:typegen         # Generate TypeScript types
pnpm typecheck                    # Type check
pnpm lint:fix                     # Fix linting
pnpm format:fix                   # Format code

Key Patterns (Quick Reference)

Pattern	Import	Details
Server Actions	`authActionClient` from `@kit/next/safe-action`	`packages/next/AGENTS.md`
Route Handlers	`enhanceRouteHandler` from `@kit/next/routes`	`packages/next/AGENTS.md`
Server Client	`getSupabaseServerClient` from `@kit/supabase/server-client`	`packages/supabase/AGENTS.md`
UI Components	`@kit/ui/{component}`	`packages/ui/AGENTS.md`
Translations	`Trans` from `@kit/ui/trans`	`packages/ui/AGENTS.md`

Authorization

RLS enforces access control - no manual auth checks needed with standard client
Admin client (getSupabaseServerAdminClient) bypasses RLS - use sparingly with manual validation

Verification

After implementation, always run:

pnpm typecheck
pnpm lint:fix
pnpm format:fix
Run code quality reviewer agent

3.1 KiB Raw Blame History