env-config
Environment variable access conventions. All env access goes through centralized config modules (apps/server/src/config.ts, apps/web/src/config.ts). Use when reading process.env, adding new env vars, or modifying config files.
Datos de origen
- Repositorio
- recca0120/code-quest
- Última actividad en el origen
- 7 de mayo de 2026 a las 14:06
- Idioma detectado de SKILL.md
- inglés
- Estrellas
- 11
- Forks
- 2
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Mostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- name
- env-config
- description
- Environment variable access conventions. All env access goes through centralized config modules (apps/server/src/config.ts, apps/web/src/config.ts). Use when reading process.env, adding new env vars, or modifying config files.
# Environment Variable Configuration
## Convention
All env access MUST go through centralized config modules — never read `process.env` or `import.meta.env` directly in application code.
| Package | Config file | Access method |
|---------|------------|---------------|
| server | `apps/server/src/config.ts` | `process.env` with defaults |
| client | `apps/web/src/config.ts` | `import.meta.env` (Vite) |
## Server Config (`apps/server/src/config.ts`)
```ts
export const config = {
port: Number(process.env.PORT ?? 3000),
databaseUrl: process.env.DATABASE_URL,
rawStore: {
drivers: parseRawStoreDrivers(process.env.RAW_STORE ?? ''),
sqlitePath: process.env.RAW_STORE_SQLITE_PATH ?? './data/code-quest.db',
fileDir: process.env.RAW_STORE_FILE_DIR ?? './data/events',
},
systemPrompt: process.env.SYSTEM_PROMPT ?? '',
allowDangerouslySkipPermissions: process.env.ALLOW_DANGEROUSLY_SKIP_PERMISSIONS !== 'false',
};
```
**Env loading**: Node.js 20+ native `--env-file` flag (no dotenv dependency).
```json
"dev": "tsx watch --env-file=.env src/bin/server.ts"
```
## Client Config (`apps/web/src/config.ts`)
```ts
export const config = {
serverUrl: (import.meta.env.VITE_SERVER_URL as string) || '',
};
```
Vite auto-loads `.env` files. Only `VITE_` prefixed vars are exposed to client.
## .env Files
| File | Location |
|------|----------|
| Server | `apps/server/.env` |
| Server example | `apps/server/.env.example` |
| Client | `apps/web/.env` |
| Client example | `apps/web/.env.example` |
## Adding a New Env Var
1. Add to the appropriate config module (`config.ts`) with a sensible default
2. Add to `.env.example` with a comment
3. If server-side, no prefix needed. If client-side, use `VITE_` prefix
4. No zod validation currently — just raw access with defaults
5. Import `config` in application code, never access env directly
## Notes
- `parseRawStoreDrivers()` parses comma-separated driver list (e.g., `'sqlite,mysql,file'`)
- `allowDangerouslySkipPermissions` defaults to `true` (only `'false'` disables it)
- Dev proxy configured in `apps/web/vite.config.ts` using `process.env.PORT`
- Test: `apps/server/src/__tests__/config.test.ts` (covers `parseRawStoreDrivers`)
Ver en GitHub