# Routing

VeloFrame uses a simple but powerful routing system to map URLs to your page controllers.

---

## How Routing Works
- All requests are routed to `index.php`.
- The framework auto-discovers controllers in the `pages/` directory (if enabled).
- Each controller can define one or more routes using special comments.

---

## Defining Routes
Add a `# @route /your-path` annotation at the top of your controller file:

```php
// pages/AboutHandler.php
# @route /about
class AboutHandler extends DefaultPageController {
    // ...
}
```

You can define multiple routes per controller by adding more `# @route` lines.

---

## Custom Routing
- Use `RoutingHandler` to manually register routes if you want full control.
- Example:
```php
$rh = new RoutingHandler();
$rh->register('/custom', new CustomHandler());
$server->setRoutingHandler($rh);
```

---

## Route Parameters
Currently, VeloFrame supports static routes. For dynamic parameters, extend the routing logic in your controllers.

---

## Tips
- Keep route paths clean and RESTful.
- Use one controller per logical page or endpoint.

See [Architecture](./Architecture.md) for the full request flow.