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.

BRAND_COUNTRY also drives money display precision: Nigeria (NGA) and Chile (CHL) render values without decimals (₦1,000, $50.000), all other countries render with two decimals (R$ 1.000,00). The choice is wired through CountryConfig.displayDecimalDigits and applied automatically by the useFormatMoney / useTransactions / useBalance hooks.