2024

Gokai

Plataforma para organização social, construída como Next.js serverless sobre Supabase. Sem backend custom — arquitetura enxuta por escolha.

Papel: Engenharia full-stack · Solo engineer
Ano: 2024
Stack: Next.js 16React 19TypeScriptTailwind CSS v4Supabase SSRshadcn/uiZodReact Hook Form

§ 02 highlights

01Next.js 16 (App Router) com Supabase SSR para autenticação e Postgres gerenciado — zero servidor próprio para operar.
02Formulários com React Hook Form + Zod tipados ponta a ponta, UI com shadcn/ui sobre Tailwind v4.
03Deploy em Vercel, sem Docker nem pipeline custom — simplicidade como vantagem competitiva para uma ONG.

§ 03 case

Contexto

Gokai é uma plataforma para uma organização social. Para uma ONG, cada hora de engenharia e cada real em infra é caro. A decisão arquitetural principal foi deliberadamente minimalista: zero backend próprio, zero infraestrutura custom, zero Docker. Contraste com Agapeon (que tem backend próprio) — esse projeto tinha requisitos diferentes, então a stack tinha que ser diferente. Engenharia pragmática é saber quando não escalar prematuramente.

Stack serverless por design

Next.js 16 em App Router com Server Components, hospedado no Vercel. Toda a persistência e autenticação delegada ao Supabase — PostgreSQL gerenciado, Auth com magic links, Row Level Security controlando acesso. Supabase SSR cuida da ponte de cookie de sessão entre server components e client components do Next. shadcn/ui + BaseUI + Tailwind v4 para uma UI consistente sem sistema de design próprio. O resultado: zero servidor para operar.

Formulários type-safe

React Hook Form + Zod para validação end-to-end. Os schemas Zod são definidos uma vez e geram tipos TypeScript, validação client-side e validação server-side nas server actions — três usos, uma fonte. Erros de validação são exibidos inline com acessibilidade preservada (aria-describedby, aria-invalid). Garante consistência entre o que o cliente envia e o que o servidor aceita, sem duplicação de regras.

Resultado

Plataforma funcional em produção para uma ONG, com custo operacional mínimo e manutenção quase zero. O modelo serverless + Supabase significa que, se o tráfego crescer 10x, a plataforma escala automaticamente sem intervenção. Se o tráfego diminuir, o custo também. Entregue solo com 54+ commits — prova de que a arquitetura certa para o contexto certo é frequentemente a menos sofisticada.