FAQ

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.

---

Still Stuck?

• Check the API Reference and Architecture.
• Open an issue on GitHub for help.