Setup do Ambiente de Desenvolvimento

Pré-requisitos

• Node.js >=20.14.0 (recomendado: 22.18.0)
• pnpm (obrigatório — não use npm ou yarn)
• Git

# Instalar pnpm (se necessário)
corepack enable
corepack prepare pnpm@latest --activate

SDK (front-cactus-core)

git clone <repo-url-sdk> front-cactus-core
cd front-cactus-core
pnpm install
pnpm build          # Build todos os pacotes
pnpm test           # Rodar testes

GitHub Packages (auth para @cactus-agents/*)

Antes de instalar os pacotes @cactus-agents/*, configure a autenticação com o GitHub Packages:

1. Crie um PAT (classic) em GitHub → Settings → Developer settings → Personal access tokens
   • Escopo: read:packages
2. Adicione ao seu ~/.npmrc global:

//npm.pkg.github.com/:_authToken=ghp_SEU_TOKEN_AQUI

Isso é necessário apenas uma vez por máquina. Para mais detalhes, veja a documentação de GitHub Packages.

Template (front-web-base)

git clone <repo-url-template> front-web-base
cd front-web-base
pnpm install

Crie os arquivos de env:

# .dev.vars (Wrangler - SSR)
API_BASE_URL=https://stage1-api-new.bs2bet.com/v2
ORIGIN_DOMAIN=stage1.gli-cactus.com
BRAND_LANGUAGE=pt-br
BRAND_COUNTRY=BRA
BRAND_CURRENCY=BRL
BRAND_TIMEZONE=America/Sao_Paulo

# .env (Vite - mesmas variáveis)
API_BASE_URL=https://stage1-api-new.bs2bet.com/v2
ORIGIN_DOMAIN=stage1.gli-cactus.com
BRAND_LANGUAGE=pt-br
BRAND_COUNTRY=BRA
BRAND_CURRENCY=BRL
BRAND_TIMEZONE=America/Sao_Paulo

pnpm dev            # Dev server em localhost:5173

Documentação (front-cactus-docs)

git clone <repo-url-docs> front-cactus-docs
cd front-cactus-docs
pnpm install
pnpm start          # Dev server em localhost:3000

IDEs

VS Code

Extensões recomendadas:

• Biome (biomejs.biome) — lint + format
• Tailwind CSS IntelliSense — autocomplete de classes
• Pretty TypeScript Errors — erros TS mais legíveis

Configuração

O Biome substitui ESLint + Prettier. Configure o VS Code para formatar com Biome:

{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true
}