Configuration

# Configuration

`nv` loads its configuration from multiple sources, in the following priority order (highest first):

### Priority Order

| Priority | Source                      | Description                                 |
|:---------|:----------------------------|:--------------------------------------------|
| 1        | Environment Variables       | `NV_API_URL`, `NV_API_TOKEN`                |
| 2        | Local Config                | `./.nv_config` in the current directory      |
| 3        | Global Config               | `~/.nv_config` in user home directory        |
| 4        | Smart Fallback              | Auto-detects local dev vs production server  |

### .nv_config Format

The config file is a JSON object:

```json
{
  "token": "your_secret_token_here",
  "url": "http://127.0.0.1:8888"
}
```

> **Note:** The `url` field is only effective in **debug mode** (`DEBUG=true` in the `.env` file). In production mode, the URL is locked to `https://www.nullvuild.com` and cannot be overridden via config.

### Debug vs Production Mode

| Mode       | URL Behavior                                     | Toggle                 |
|:-----------|:-------------------------------------------------|:-----------------------|
| Production | Locked to `https://www.nullvuild.com`             | `DEBUG=false` or unset |
| Debug      | Configurable via menu or config file              | `DEBUG=true` in `.env` |

### Smart Fallback (Debug Mode)

When in debug mode and no URL is explicitly set, the CLI checks if an `api_server/` directory exists nearby. If found, it defaults to `http://127.0.0.1:8888`. Otherwise, it falls back to the production URL.

// COMMENTS

ON THIS PAGE