Environment Configuration

Edit frontend/.env after scaffolding. The key variables:

# Backend API URL — use your app's domain, not localhost
VITE_API_BASE_URL=http://yourdomain.com:8000

# Routes to proxy from the dev server to the backend
# Must include /api and /appbuilder — add all your CRUD module routes
VITE_PROXY_ROUTES=/api,/appbuilder,/patients,/doctors

# Environment flag
VITE_APP_ENV=development

VITE_PROXY_ROUTES — Critical Rules

The dev server proxies these URL prefixes to your Zango backend. Get this wrong and your pages will 404.

✅ Include:

• /api — always required
• /appbuilder — always required
• Every route path your CRUD views are mounted at (e.g. /patients, /orders)

❌ Never include:

• /app — this is a frontend route handled by the React router, not the backend

Example — if you have patients and doctors modules:

VITE_PROXY_ROUTES=/api,/appbuilder,/patients,/doctors

VITE_API_BASE_URL

Use the app's domain URL, not localhost. In development this is typically http://yourdomain.com:8000 where yourdomain.com is the domain you configured for your app (added to /etc/hosts).