PHPackages                             chappy-php/chappy-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. chappy-php/chappy-php

ActiveProject[Framework](/categories/framework)

chappy-php/chappy-php
=====================

Starter project for Chappy PHP Framework.

v2.1.0(2mo ago)1112[1 issues](https://github.com/chapmancbVCU/chappy-php-starter/issues)MITPHPPHP >=8.4CI passing

Since Mar 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/chapmancbVCU/chappy-php-starter)[ Packagist](https://packagist.org/packages/chappy-php/chappy-php)[ RSS](/packages/chappy-php-chappy-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (78)Used By (0)

 [![Chappy.php logo](public/logo.png)](public/logo.png)

Chappy.php Starter Application
==============================

[](#chappyphp-starter-application)

[Visit our Wiki](https://chapmancbvcu.github.io/chappy-php-starter/)

**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.

---

🚀 Quick Start
-------------

[](#-quick-start)

1. **Install system dependencies**:

- PHP 8.4+
- Composer
- npm

2. **Create a new project**:

```
composer create-project chappy-php/chappy-php my-app
cd my-app
```

3. **Run the development server:**

```
php console serve
```

4. **Start Vite dev server:**

```
npm run dev
```

Running above command in Windows PowerShell can cause an issue. Make sure to run with Command Prompt.
-----------------------------------------------------------------------------------------------------

[](#running-above-command-in-windows-powershell-can-cause-an-issue--make-sure-to-run-with-command-prompt)

🧰 Features

- ⚛️ Native React.js View Support
- 💡 Lightweight, fast PHP MVC core
- 🧭 Dynamic routing with controllers
- 🧱 Layouts, components, and templating
- 🔐 Built‑in user authentication & ACL
- ✍️ Custom form handling and validation
- 📥 Secure file uploads
- 🔔 Email service with customizable templates
- 📡 Event/Listener system for decoupled logic
- 🧵 Job dispatching and background queue support
- 🧪 Unit testing with PHPUnit, Vitest, and test API helpers
- 🔥 Vite‑based asset bundling
- 🎛 Symfony Console–powered CLI (console)
- 🌱 Seeders, migrations, and database helpers
- 📊 Doctum‑generated API documentation
- 📖 Built‑in Jekyll user guide
- 🧾 .env configuration via vlucas/phpdotenv
- 📂 Organized PSR‑4 project structure
- 📚 [Jekyll user guide](https://chapmancbvcu.github.io/chappy-php-starter/)

---

System Requirements
-------------------

[](#system-requirements)

- Apache or Nginx (or XAMPP)
- PHP 8.4
- MySQL or MariaDB
- Composer, Node.js, npm
- SQL Management software
- Composer
- git
- OS: macOS / Linux / Windows 11+

---

📄 Documentation Full documentation is included with the project. After setup, access:

- 📘 User Guide
- 🔧 API Reference

---

📬 Contact Questions or suggestions? 📧 . 🐛 [Open an issue](https://github.com/chapmancbVCU/chappy-php-framework/issues)

---

🌐 Social Youtube:

---

🏆 Credits

1. “mvc” icon by iconixar, from thenounproject.com.
2. Freeskills on YouTube ()

---

**Release Notes**

[v2.0.0](https://chapmancbvcu.github.io/chappy-php-starter/jekyll/update/2026/01/25/Version-2-ReleaseNotes.html)

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance67

Regular maintenance activity

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

76

Last Release

84d ago

Major Versions

v1.4.12 → v2.0.02026-01-25

PHP version history (3 changes)v1.0.0PHP >=8.3

v1.4.8PHP >=8.2

v1.4.10PHP >=8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/9b7648f9e08991fa55dc2e567c8594495e7f807983778e6686c4db94c6d24f31?d=identicon)[chapmancbVCU](/maintainers/chapmancbVCU)

---

Top Contributors

[![chapmancbVCU](https://avatars.githubusercontent.com/u/48930669?v=4)](https://github.com/chapmancbVCU "chapmancbVCU (1426 commits)")

### Embed Badge

![Health badge](/badges/chappy-php-chappy-php/health.svg)

```
[![Health](https://phpackages.com/badges/chappy-php-chappy-php/health.svg)](https://phpackages.com/packages/chappy-php-chappy-php)
```

###  Alternatives

[laravel/telescope

An elegant debug assistant for the Laravel framework.

5.2k67.8M192](/packages/laravel-telescope)[spiral/roadrunner

RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins

8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper

Most modern mobile touch slider and framework with hardware accelerated transitions

41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts

Add beautiful and user-friendly forms to your command-line applications.

708181.8M596](/packages/laravel-prompts)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)