# Environment Variables

This reference describes the key environment variables used by Turista.

## Application

| Variable | Default | Description |
|----------|---------|-------------|
| `APP_NAME` | Laravel | Application name. |
| `APP_ENV` | local | Environment: `local`, `testing`, `production`. |
| `APP_DEBUG` | false | Enables debug responses. Must be `false` in production. |
| `APP_KEY` | | Encryption key. Generate with `php artisan key:generate`. |
| `APP_URL` | http://localhost | Public URL of the application. |
| `APP_TIMEZONE` | UTC | Application timezone. |
| `APP_LOCALE` | en | Application locale. |

## Database

| Variable | Default | Description |
|----------|---------|-------------|
| `DB_CONNECTION` | mysql | Database driver. Tests use SQLite. |
| `DB_HOST` | 127.0.0.1 | Database host. |
| `DB_PORT` | 3306 | Database port. |
| `DB_DATABASE` | turista | Database name. |
| `DB_USERNAME` | root | Database user. |
| `DB_PASSWORD` | | Database password. |

## Sanctum

| Variable | Default | Description |
|----------|---------|-------------|
| `SANCTUM_TOKEN_EXPIRATION` | 10080 | Token lifetime in minutes (1 week). |
| `SANCTUM_STATEFUL_DOMAINS` | | Comma-separated list of stateful domains. |

## Mail

| Variable | Default | Description |
|----------|---------|-------------|
| `MAIL_MAILER` | `log` | Mail driver (`smtp`, `log`, etc.). Must be changed to a real provider in production. |
| `MAIL_HOST` | | SMTP host. |
| `MAIL_PORT` | | SMTP port. |
| `MAIL_USERNAME` | | SMTP username. |
| `MAIL_PASSWORD` | | SMTP password. |
| `MAIL_ENCRYPTION` | | TLS/SSL. |
| `MAIL_FROM_ADDRESS` | `hello@example.com` | Default from address. |
| `MAIL_FROM_NAME` | `APP_NAME` | Default from name. |

## CoreVerde WhatsApp

| Variable | Description |
|----------|-------------|
| `COREVERDE_BASE_URL` | CoreVerde API base URL. |
| `COREVERDE_API_TOKEN` | API token. |
| `COREVERDE_DEVICE_ID` | Device ID. |
| `COREVERDE_ENABLED` | Set to `true` to enable WhatsApp sending. |

## Request Docs

| Variable | Default | Description |
|----------|---------|-------------|
| `REQUEST_DOCS_ENABLED` | false | Enables `/request-docs` UI. Disable in production. |

## CORS

| Variable | Description |
|----------|-------------|
| `CORS_ALLOWED_ORIGINS` | Comma-separated allowed origins. |

## Locations

| Variable | Default | Description |
|----------|---------|-------------|
| `SEED_COUNTRIES` | Libya | Comma-separated countries to seed. |

## Queue

| Variable | Default | Description |
|----------|---------|-------------|
| `QUEUE_CONNECTION` | database | Queue driver. |

## Cache

| Variable | Default | Description |
|----------|---------|-------------|
| `CACHE_STORE` | database | Cache driver. |

## Logging

| Variable | Default | Description |
|----------|---------|-------------|
| `LOG_CHANNEL` | stack | Log channel. |
| `LOG_LEVEL` | debug | Minimum log level. |