PHPackages jinomial/fw-app-skeleton - 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. jinomial/fw-app-skeleton ActiveProject[Framework](/categories/framework) jinomial/fw-app-skeleton ======================== The FW application skeleton. v1.0.3(3mo ago)03MITPHPPHP >=8.3.0CI failing Since Mar 7Pushed 3mo agoCompare [ Source](https://github.com/jinomial/fw-app-skeleton)[ Packagist](https://packagist.org/packages/jinomial/fw-app-skeleton)[ RSS](/packages/jinomial-fw-app-skeleton/feed)WikiDiscussions master Synced 3w ago READMEChangelog (1)Dependencies (10)Versions (5)Used By (0) Your FW Framework Application ============================= [](#your-fw-framework-application) Welcome to your new FW Framework application! FW is a modern, fast, async-first PHP framework built for performance and modularity. This skeleton provides a robust starting point for building scalable APIs and web applications. ๐Ÿš€ Getting Started ----------------- [](#-getting-started) Follow these steps to get your local environment up and running: ### 1. Configure the Environment [](#1-configure-the-environment) Copy the example environment file. This file contains the configuration for your database, cache, and application secrets. ``` cp .env.example .env ``` *(Remember: the `.env` file is loaded exactly **once** when the Swoole server boots. If you change a value, you must restart the server.)* ### 2. Compile the Application [](#2-compile-the-application) FW is a **compiled framework**. Before the application can serve requests, you must compile your declarative routing matrix, database schemas, views, and strict Dependency Injection (DI) container. We provide the `fw` CLI tool (installed via Composer) to handle this. You can compile everything at once using the handy developer script: ``` # Formats code, runs static analysis, compiles everything, and restarts the local server ./bin/dev.sh ``` Or you can run individual compilation commands via the CLI: ``` php vendor/bin/fw build:api php vendor/bin/fw build:db php vendor/bin/fw build:view php vendor/bin/fw build:container ``` ### 3. Start the Async Worker [](#3-start-the-async-worker) FW relies on a persistent memory execution model (Swoole) rather than the traditional PHP request lifecycle. Start the application stack using Docker: ``` docker compose up -d ``` Your application will now be live at `http://localhost:8000`! --- ๐Ÿ—๏ธ Directory Structure Overview ------------------------------- [](#๏ธ-directory-structure-overview) FW enforces a **Domain-Driven Design** modular structure instead of traditional monolithic `app/Controllers` and `app/Models` directories. - **`modules/`**: The heart of your application. Group your logic by feature or domain (e.g., `User`, `Auth`, `Post`). Each module contains its own routing, models, and logic. - **`api/`**: Declarative YAML definitions mapping endpoints to your module logic. - **`database/`**: Contains `schema.yaml` which defines your database structure, along with raw SQL migrations. - **`build/`**: The compiled, blazing-fast static PHP files generated by the `fw` CLI. **Do not edit these manually.** - **`config/`**: Contains framework configuration and `dependencies.php` for binding custom factories into the DI container. - **`public/`**: The public-facing entry point, containing `server.php` which bootstraps the persistent Swoole worker. ๐Ÿงช Testing and Tooling --------------------- [](#-testing-and-tooling) Your application comes pre-configured with industry-standard tooling: - **Testing**: We use Pest PHP. Run your test suite with: ``` vendor/bin/pest ``` - **Static Analysis**: PHPStan is configured to catch errors before runtime: ``` vendor/bin/phpstan analyse ``` Happy building! ๐Ÿš€ ### Health Score 37 โ€” LowBetter than 81% of packages Maintenance79 Regular maintenance activity Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record 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 ~0 days Total 4 Last Release 109d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/26f680a2a0545691ca0b1e8268798ef37d6ab3f0942289914d7a58f49efddf99?d=identicon)[jinomial](/maintainers/jinomial) --- Top Contributors [![jinomial](https://avatars.githubusercontent.com/u/91918643?v=4)](https://github.com/jinomial "jinomial (14 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/jinomial-fw-app-skeleton/health.svg) ``` [![Health](https://phpackages.com/badges/jinomial-fw-app-skeleton/health.svg)](https://phpackages.com/packages/jinomial-fw-app-skeleton) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.8k532.1M19.4k](/packages/laravel-framework)[tempest/framework The PHP framework that gets out of your way. 2.2k31.1k12](/packages/tempest-framework)[oro/platform Business Application Platform (BAP) 642140.7k104](/packages/oro-platform)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.4M517](/packages/shopware-core)[rcsofttech/audit-trail-bundle Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking. 1155.2k](/packages/rcsofttech-audit-trail-bundle) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)