# FAQ & Troubleshooting

Find answers to common questions and solutions to typical problems with VeloFrame.

---

## General
**Q: What PHP version is required?**  
A: PHP 7 or higher.

**Q: Do I need Composer or external libraries?**  
A: No, VeloFrame has no external dependencies.

---

## Setup Issues
**Q: I get a 404 or blank page.**  
A: Ensure `.htaccess` is present and your web server supports URL rewriting. For local dev, use Apache or configure your server to route all requests to `index.php`.

**Q: My templates/components aren’t loading.**  
A: Check file names, locations, and permissions. Templates go in `templates/`, components in `templates/components/`.

---

## Debugging
**Q: How do I see debug output?**  
A: Set `DEBUG` to `2` in `VeloFrame/config.php`. Debug messages appear as HTML comments if `AUTO_COMMENT_DEBUG` is enabled.

**Q: How do I optimize performance?**  
A: Disable unused features in `config.php` and set `DEBUG` to `0` for production.

---

## Contributing
**Q: How do I contribute?**  
A: See [Contributing](./Contributing.md).

---

## Still Stuck?
- Check the [API Reference](./API-Reference.md) and [Architecture](./Architecture.md).
- Open an issue on GitHub for help.