PHPackages                             webfiori/app - 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. webfiori/app

ActiveProject[Framework](/categories/framework)

webfiori/app
============

The default application template for WebFiori Framework.

v3.0.0(2w ago)212.0kPHPPHP &gt;=8.1CI passing

Since May 5Pushed 2w ago1 watchersCompare

[ Source](https://github.com/WebFiori/app)[ Packagist](https://packagist.org/packages/webfiori/app)[ RSS](/packages/webfiori-app/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (4)Versions (39)Used By (0)

WebFiori App Template
=====================

[](#webfiori-app-template)

 [![WebFiori Logo](https://camo.githubusercontent.com/f4abc7aa878a4465db6ab6ae18bbfb7c763af4a6d12d4a379692e0886be589f5/68747470733a2f2f77656266696f72692e636f6d2f6173736574732f696d616765732f66617669636f6e2e706e67)](https://camo.githubusercontent.com/f4abc7aa878a4465db6ab6ae18bbfb7c763af4a6d12d4a379692e0886be589f5/68747470733a2f2f77656266696f72692e636f6d2f6173736574732f696d616765732f66617669636f6e2e706e67)

 [![Build Status](https://github.com/WebFiori/app/workflows/PHP%20Build/badge.svg?branch=main)](https://github.com/WebFiori/app/actions) [![Latest Release](https://camo.githubusercontent.com/edf2fc66e603aebdfca1109b52e23d3f89aa5d77fc844e2ec4d3091c16a2f7c4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6170702e7376673f6c6162656c3d6c6174657374)](https://github.com/WebFiori/app/releases) [![Downloads](https://camo.githubusercontent.com/9206c052bcf09c9f8b29eebff06957966161bbdce33dd07d2b9830c13add7b65/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77656266696f72692f6170703f636f6c6f723d6c696768742d677265656e)](https://packagist.org/packages/webfiori/app)

The default application template for [WebFiori Framework](https://github.com/WebFiori/framework). Use this as a starting point to create new WebFiori projects.

Requirements
------------

[](#requirements)

- PHP &gt;= 8.1
- Extensions: `json`, `mbstring`, `fileinfo`, `openssl`
- [Composer](https://getcomposer.org/)

Quick Start
-----------

[](#quick-start)

```
composer create-project webfiori/app my-site
cd my-site
php -S localhost:8080 -t public
```

Then open  in your browser.

Project Structure
-----------------

[](#project-structure)

```
├── public/             # Web server document root
│   ├── index.php       # Application entry point
│   ├── .htaccess       # Apache rewrite rules
│   ├── web.config      # IIS rewrite rules
│   └── assets/         # Static files (CSS, JS, images)
├── App/                # Application source code
│   ├── Apis/           # REST API services
│   ├── Commands/       # Custom CLI commands
│   ├── Config/         # Configuration files (auto-generated)
│   ├── Database/       # Migrations, seeders, tables
│   ├── Domain/         # Domain entities
│   ├── Health/         # Health check implementations
│   ├── Ini/            # Initialization and route definitions
│   ├── Langs/          # Internationalization files
│   ├── Middleware/     # Custom middleware
│   ├── Pages/          # Page controllers and views
│   ├── Policies/       # ABAC policy classes
│   ├── Storage/        # Sessions, logs, uploads (not web-accessible)
│   └── Tasks/          # Background jobs and scheduled tasks
├── tests/              # PHPUnit tests
├── composer.json
├── webfiori            # CLI entry point (Linux/macOS)
└── webfiori.bat        # CLI entry point (Windows)

```

Customizing the App Directory
-----------------------------

[](#customizing-the-app-directory)

By default, the framework uses `App/` as the application root directory. To change this, edit the first parameter of `App::initiate()` in `public/index.php`:

```
App::initiate('MyApp', 'public', __DIR__);
```

Reasons you might want to rename it:

- Gives your project a distinct identity instead of a generic `App/` folder.
- Avoids naming conflicts if you're integrating WebFiori into an existing project that already has an `App/` directory.
- Makes it easier to distinguish between multiple WebFiori-based projects in the same workspace.

Running Tests
-------------

[](#running-tests)

```
composer test
```

Code Style
----------

[](#code-style)

This project uses [PHP CS Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer) for code style enforcement.

```
composer cs-check   # Check for violations (dry run)
composer cs-fix     # Auto-fix violations
```

CLI Usage
---------

[](#cli-usage)

WebFiori includes a CLI tool for common tasks:

```
# Linux/macOS
php webfiori

# Windows
webfiori.bat
```

Common commands:

```
php webfiori create:service       # Create a new API service
php webfiori create:middleware    # Create a new middleware
php webfiori create:migration    # Create a database migration
php webfiori create:command      # Create a custom CLI command
php webfiori migrations:run      # Run pending migrations
php webfiori migrations:step     # Interactively apply/skip migrations
php webfiori routes:cache        # Build route cache for production
php webfiori services:list       # List auto-discovered API services
php webfiori help                # Show all available commands
```

Documentation
-------------

[](#documentation)

- [Getting Started](https://webfiori.com/learn)
- [API Reference](https://webfiori.com/docs)
- [Framework Repository](https://github.com/WebFiori/framework)

Contributing
------------

[](#contributing)

For information on how to contribute, see [the contribution guide](https://webfiori.com/contribute).

Reporting Issues
----------------

[](#reporting-issues)

- For bugs and feature requests, [open an issue](https://github.com/WebFiori/app/issues/new).
- For security vulnerabilities, please email .

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE).

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance96

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 96.8% 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 ~54 days

Recently: every ~107 days

Total

35

Last Release

19d ago

Major Versions

v0.1 → v2.2.02021-05-05

v2.4.7 → v3.0.0-RC22023-01-03

PHP version history (3 changes)v0.1PHP &gt;=5.6

v3.0.0-RC2PHP &gt;=7.0

v3.0.0-RC0PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c25e43acaa22b4fb758a710b69c2ab75947a6642925e3bec9c98196b1f2a433?d=identicon)[usernane](/maintainers/usernane)

---

Top Contributors

[![usernane](https://avatars.githubusercontent.com/u/12120015?v=4)](https://github.com/usernane "usernane (213 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")

---

Tags

frameworkhactoberfesthtmlphp

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/webfiori-app/health.svg)

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

###  Alternatives

[laravel/dusk

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

1.9k39.6M300](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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