Pular para o conteúdo
§ Projetos Open Source · Dev Tools

kayoridolfi-ai-site (template OSS)

Boilerplate full-stack para sites institucionais com blog, captação de leads, backoffice administrativo, LGPD nativa e design system pronto. Reutilizável para múltiplas marcas — incluindo este próprio site e o AUMAF.

  • Cliente Open source
  • Indústria Open Source · Dev Tools
  • Ano 2026
§ 01 · Desafio

O desafio.

Cada novo cliente exigia recriar o mesmo conjunto: site institucional + admin + blog + lead capture + LGPD. Reescrever do zero a cada projeto é desperdício e o cliente paga por isso. Template precisava ser tokenizado para rebranding em horas, não dias.

§ 02 · Abordagem

Como abordamos.

  1. A01

    Arquitetura: Astro 5 (público) + React/Vite (admin) + Node/Express/Prisma (backend) + Postgres 16 + Redis 7 + MinIO/S3.

  2. A02

    Design system tokenizado (Atelier HUD) com tema substituível por marca — templateConfig.ts como single source of truth, CSS variables por tema.

  3. A03

    CLIs `brand:init` e `theme` para bootstrap rápido. Documentação em docs/template/ cobrindo rebrand, theming, conteúdo, deploy VPS.

  4. A04

    LGPD nativa: consent manager, cookies, política, DSR endpoints, retenção configurável — não bolted-on, faz parte do template.

  5. A05

    CI/CD com CodeQL, Dependabot, build/typecheck/test em PR.

§ 03 · Resultado

O que foi entregue.

Template em produção em pelo menos 2 sites reais (kayoridolfi.ai, aumaf3d.com.br). Repositório upstream público com contribuições e backlog de melhorias documentado em TEMPLATE-IMPROVEMENTS.md.

§ 04b · Stack

Stack técnica.

  • Astro 5
  • React 18 + Vite
  • Node 20 + Express
  • Prisma + Postgres 16
  • Redis 7
  • Tailwind CSS
  • Zod
  • Playwright
§ 04c · Aprendizados

O que levaria para o próximo.

  1. L01

    Single source of truth para identidade (templateConfig) economiza horas — mas exige disciplina de nunca hardcodar.

  2. L02

    CSS variables vencem qualquer abstração de "design tokens" sofisticada quando o objetivo é trocar tema sem rebuild.

  3. L03

    LGPD nativa cria reuso entre projetos brasileiros — o boilerplate jurídico é tão valioso quanto o código.

ossastrodesign-systemtemplatelgpd
§ próximo · p. ∞

Quer um resultado parecido?