# Environment Variables

Configure your Nexus theme storefront with environment variables.

## Variables

```bash
# Required - Finqu API
FINQU_STOREFRONT_URL=https://your-storefront.finqu.dev
FINQU_SECRET_KEY=sk_...
NEXT_PUBLIC_FINQU_STOREFRONT_URL=https://your-storefront.finqu.dev
NEXT_PUBLIC_FINQU_STOREFRONT_TOKEN=pk_...

# Optional - Redis (enables production storage for templates)
UPSTASH_REDIS_REST_URL=https://...
UPSTASH_REDIS_REST_TOKEN=...
```

| Variable                            | Required | Description                         |
| ---------------------------------- | -------- | ----------------------------------- |
| `FINQU_STOREFRONT_URL`             | Yes      | Finqu storefront API URL            |
| `FINQU_SECRET_KEY`                 | Yes      | Secret API key (server-side only)   |
| `NEXT_PUBLIC_FINQU_STOREFRONT_URL` | Yes      | Public storefront URL (client-side) |
| `NEXT_PUBLIC_FINQU_STOREFRONT_TOKEN` | Yes    | Public API token (client-side)      |
| `UPSTASH_REDIS_REST_URL`           | No       | Redis URL for production storage    |
| `UPSTASH_REDIS_REST_TOKEN`         | No       | Redis token for production storage  |

## Storage

- **Development** – When Redis vars are not set, templates are stored in the `data/` directory.
- **Production** – When `UPSTASH_REDIS_REST_URL` is set, templates are stored in Redis.

## Security

- Never commit secrets; add `.env.local` to `.gitignore`.
- Only `NEXT_PUBLIC_*` variables are available in the browser; do not put secrets there.

## Next Steps

- [Installation](./installation) - Set up your storefront
- [Architecture](./architecture) - Understand how storage works
- [Troubleshooting](./troubleshooting) - Common issues