Bem-vindo à documentação interna de front-end da plataforma Cactus Gaming. Este espaço cobre tudo que o time de desenvolvimento precisa saber para trabalhar no ecossistema de front.
O que você encontra aqui
- Arquitetura — Visão geral do sistema, multi-tenancy, fluxos de auth e brand
- SDK (@cactus-agents/*) — Pacotes TypeScript do monorepo
front-cactus-core
- Template (front-web-base) — O template React Router v7 que todo fork herda
- Fork de Marca — Como criar e manter forks de clientes
- Endpoints — Mapa completo da API backend
- Contributing — Setup do ambiente, convenções de código e PRs
Repositórios
| Repo | Descrição | Status |
|---|
front-cactus-core | SDK TypeScript — pacotes @cactus-agents/* | Em andamento |
front-web-base | Template React Router v7 (SSR / Cloudflare Workers) | Em andamento |
front-cactus-docs | Esta documentação (Docusaurus) | Em andamento |
front-web-vera-bet-br | Fork Vera (primeiro tema) | Pendente |
front-web-panel | Painel admin (vault + deploys) | Pendente |
front-ops | Vault de envs + scripts de build/deploy | Pendente |
Stack principal
| Camada | Tecnologia |
|---|
| Framework | React Router v7 (SSR nativo no Cloudflare Workers) |
| Build | Vite |
| Styling | Tailwind CSS v3 + CSS custom properties |
| State (client) | Zustand |
| State (server) | React Router loaders |
| Linter/formatter | Biome |
| Testes | Vitest + React Testing Library |
| Package manager | pnpm (enforced) |
| Node | >=20.14.0 (recomendado: 22.18.0) |