The new Glific frontend (Glific 2.0). React + TypeScript + Vite, shadcn/ui + Tailwind v4, React Router, TanStack Query, i18next.
Requirements: Node 24 (.nvmrc), pnpm 12 (corepack enable).
Like the current app, the console runs on https://glific.test:3000. One-time setup (skip what you already have from the current app or backend):
# /etc/hosts
127.0.0.1 glific.test
127.0.0.1 api.glific.testThe dev server reuses the backend's mkcert certificate from ../glific/priv/cert (set GLIFIC_CERT_DIR if your
backend lives elsewhere). Without it, it falls back to plain http.
pnpm install # also installs git hooks (lefthook)
pnpm exec playwright install chromium # browser for component and E2E tests
pnpm dev # https://glific.test:3000 against your local backend (api.glific.test:4001)
pnpm dev:mock # same, but MSW answers the API: no backend needed
GLIFIC_DEV_PORT=3001 pnpm dev # run beside the current app, which also uses 3000pnpm dev signs in with your real local credentials, like the current app. In pnpm dev:mock, sign in with any
phone number and the password password. The backend's websocket origin check expects port 3000, so live updates
on another port need that origin added to the backend's REQUEST_ORIGIN.
pnpm test:e2e runs against a real backend on https://api.glific.test:4001 with the dev seeds loaded (mix setup),
the same way CI does. It reuses pnpm dev if it's running, otherwise starts it. Tests sign in as the seed users in
e2e/fixtures.ts.
Environment variables are validated at startup (src/lib/env.ts); see .env.example. Dev defaults are in
.env.development; put local overrides in .env.local.
| Command | |
|---|---|
pnpm dev |
Dev server on https://glific.test:3000 against the local backend (dev:mock for MSW) |
pnpm build / pnpm preview |
Production build / serve it |
pnpm check |
Typecheck, lint, design-system lint, unit + component tests |
pnpm lint:fix |
Format and fix with Biome |
pnpm test / pnpm test:watch / pnpm test:coverage |
Vitest Browser Mode |
pnpm test:e2e |
Playwright flows and axe checks against your local backend (see below) |
pnpm size |
Bundle size budgets (after pnpm build) |
pnpm changeset |
Record a user-facing change |
AGENTS.md: conventions, design-system rules and how to verify a change (for humans and AI agents)docs/specs/: feature specs