# Configuration

VeloFrame offers a range of configuration options to help you tailor the framework to your needs. All options are set in `VeloFrame/config.php`.

---

## Available Options

| Constant                        | Default | Description |
|----------------------------------|---------|-------------|
| `DEBUG`                         | 2       | Debug level: 0 = Off, 1 = Warnings, 2 = Info + Warnings |
| `ALLOW_INLINE_COMPONENTS`       | TRUE    | Enable inline component processing (may impact performance) |
| `AUTO_FIND_PAGES`               | TRUE    | Auto-discover page controllers in the `pages/` directory |
| `AUTO_COMMENT_DEBUG`            | TRUE    | Print debug messages as HTML comments |
| `SERVICE_ATTRIB`                | TRUE    | Add `X-Powered-By: URW-CE-IT/VeloFrame` header |
| `AUTO_OPTIMIZE_CSS`             | TRUE    | Minify CSS by removing comments/whitespace |
| `AUTO_OPTIMIZE_JS`              | TRUE    | Minify JS by removing comments/whitespace |
| `AUTO_OPTIMIZE_IMAGES`          | TRUE    | Optimize images (remove metadata, compress) |
| `AUTO_OPTIMIZE_IMAGES_MAX_RESOLUTION` | 1080 | Max resolution for auto-optimized images |
| `CACHE_DIR`                     | `VeloFrame/cache/` | Directory for optimized files (must be writable) |

---

## Example
```php
define("DEBUG", 2);
define("ALLOW_INLINE_COMPONENTS", TRUE);
// ...
```

---

## Tips
- For production, set `DEBUG` to 0.
- Disable features you don't use for better performance.
- Ensure `CACHE_DIR` is writable by your web server.

See [Architecture](./Architecture.md) for how these options affect the framework's flow.