Chappy.php is a lightweight, extensible MVC PHP framework designed for developers who want clarity, power, and flexibility in their projects.
Originally a fork of the Ruah PHP MVC framework inspired by Freeskills’ YouTube series, we've expanded it with modern tools, cleaner structure, and new features.
- Install system dependencies:
- PHP 8.3+
- Composer
- npm
- Create a new project:
composer create-project chappy-php/chappy-php my-app
cd my-app- Run the development server:
php console serve- Start Vite dev server:
npm run dev🧰 Features
- ✍️ Custom form handling & validation
- 🧭 Dynamic routing
- 🧪 Unit test support
- 🧑💻 User authentication & ACL
- 🔥 Vite-based asset bundling
- 🧱 Layouts, components, and views
- 📊 API docs via Doctum
- 📖 Built-in documentation using Jekyll
- 🎛 Command-line support via Symfony Console
- 📥 Secure file uploads
- 📦 Seeders, migrations, and database helpers
- Apache or Nginx (or XAMPP)
- PHP 8.3
- MySQL or MariaDB
- Composer, Node.js, npm
- SQL Management software
- Composer
- git
- OS: macOS / Linux / Windows 10+
📄 Documentation Full documentation is included with the project. After setup, access:
- 📘 User Guide
- 🔧 API Reference
📬 Contact Questions or suggestions? 📧 chad.chapman2010@gmail.com. 🐛 Open an issue
🌐 Social Youtube: https://www.youtube.com/@chappy-php
🏆 Credits
- “mvc” icon by iconixar, from thenounproject.com.
- Freeskills on YouTube (https://www.youtube.com/playlist?list=PLFPkAJFH7I0keB1qpWk5qVVUYdNLTEUs3)