Installation
Clone your fork
git clone <your-fork-url>
cd front-web-<your-brand>
Install dependencies
pnpm install
This will install all dependencies including @cactus-agents/* packages from GitHub Packages.
Configure environment variables
Create two files in the project root:
.dev.vars
API_BASE_URL=https://your-api-url.com/v2
ORIGIN_DOMAIN=your-domain.com
BRAND_LANGUAGE=pt-br
BRAND_COUNTRY=BRA
BRAND_CURRENCY=BRL
BRAND_TIMEZONE=America/Sao_Paulo
.env
Same variables as .dev.vars:
API_BASE_URL=https://your-api-url.com/v2
ORIGIN_DOMAIN=your-domain.com
BRAND_LANGUAGE=pt-br
BRAND_COUNTRY=BRA
BRAND_CURRENCY=BRL
BRAND_TIMEZONE=America/Sao_Paulo
informação
Both files are needed for local development. .dev.vars is read by the SSR server (Wrangler), .env is read by the build tool (Vite).
Variable reference
| Variable | Description | Example |
|---|---|---|
API_BASE_URL | Backend API base URL | https://api.example.com/v2 |
ORIGIN_DOMAIN | Your brand's domain | mybrand.com |
BRAND_LANGUAGE | Default language code | pt-br |
BRAND_COUNTRY | Country ISO code | BRA |
BRAND_CURRENCY | Currency code | BRL |
BRAND_TIMEZONE | Timezone | America/Sao_Paulo |
You will receive the correct values from the Cactus team.