PHPackages beauty-framework/module-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. beauty-framework/module-app ActiveProject[Framework](/categories/framework) beauty-framework/module-app =========================== Beauty Framework app 1.0.3(10mo ago)01MITPHPPHP >=8.1 Since Jun 22Pushed 10mo agoCompare [ Source](https://github.com/beauty-framework/module-app)[ Packagist](https://packagist.org/packages/beauty-framework/module-app)[ RSS](/packages/beauty-framework-module-app/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (7)Versions (4)Used By (0) [![logo](https://private-user-images.githubusercontent.com/24874264/453850184-56a1d64d-8470-481a-b58e-33585270279c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0OTUyOTcsIm5iZiI6MTc3NTQ5NDk5NywicGF0aCI6Ii8yNDg3NDI2NC80NTM4NTAxODQtNTZhMWQ2NGQtODQ3MC00ODFhLWI1OGUtMzM1ODUyNzAyNzljLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDE3MDMxN1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTlkZTU4ZjBmMDIzMTVlNTQ5YjdhZjZhMGY5ZmRmMjBlZWZmZDEwYmFkZDViZWM4NmQyZjk5OTUzNDM5ZGIwYTAmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.Ll5zq5sFd4-aMhs3IfH9H33GMqp6NViqPJPH1xqLn1k)](https://private-user-images.githubusercontent.com/24874264/453850184-56a1d64d-8470-481a-b58e-33585270279c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0OTUyOTcsIm5iZiI6MTc3NTQ5NDk5NywicGF0aCI6Ii8yNDg3NDI2NC80NTM4NTAxODQtNTZhMWQ2NGQtODQ3MC00ODFhLWI1OGUtMzM1ODUyNzAyNzljLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDE3MDMxN1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTlkZTU4ZjBmMDIzMTVlNTQ5YjdhZjZhMGY5ZmRmMjBlZWZmZDEwYmFkZDViZWM4NmQyZjk5OTUzNDM5ZGIwYTAmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.Ll5zq5sFd4-aMhs3IfH9H33GMqp6NViqPJPH1xqLn1k) ๐Ÿงฑ Beauty Framework ================== [](#-beauty-framework) **Beauty** is a blazing-fast, PSR-compliant, modular microframework for building REST and gRPC APIs on top of RoadRunner. It provides first-class support for clean architecture, strong developer ergonomics, and production-ready features without FPM overhead. This skeleton is ideal for building microservices, APIs, and gRPC services with Modular Architecture. --- ๐ŸŽฏ Goals ------- [](#-goals) Beauty is designed as a lightweight, modular and fast foundation for building microservices: - ๐Ÿงฉ Package-oriented: each module is self-contained and reusable - ๐Ÿš€ RoadRunner-native: zero FPM, ultra-low latency - โš™๏ธ Clean architecture: clear separation between application layers - ๐Ÿงช Testing-friendly: services are testable by design - ๐Ÿณ Docker-first: fully containerized by default - ๐Ÿ“ฆ Modularity: easy to extend --- ๐Ÿš€ Features ---------- [](#-features) - Fully PSR-compliant (PSR-3, 4, 7, 11, 15, 14) - Built-in DI container (PHP-DI powered) - Attribute-based routing and middleware - Event system with listener registry - Lightweight config and cache system - Jobs, events, queues (via RoadRunner) - Console kernel for CLI tools - Powered by RoadRunner โ€” no FPM - Modular architecture --- ๐Ÿ—‚ Project Structure ------------------- [](#-project-structure) ``` โ”œโ”€โ”€ app โ”‚ โ”œโ”€โ”€ Console # CLI commands โ”‚ โ””โ”€โ”€ Container # DI bindings for core services โ”œโ”€โ”€ modules โ”‚ โ””โ”€โ”€ hello # Example module โ”‚ โ”œโ”€โ”€ composer.json # Module metadata โ”‚ โ””โ”€โ”€ src โ”‚ โ”œโ”€โ”€ Container # Module-specific DI bindings โ”‚ โ”œโ”€โ”€ Controllers # HTTP/API controllers โ”‚ โ”œโ”€โ”€ Events # Application events โ”‚ โ”œโ”€โ”€ Jobs # Async jobs โ”‚ โ”œโ”€โ”€ Listeners # Event listeners โ”‚ โ”œโ”€โ”€ Middlewares # PSR-15 middleware โ”‚ โ”œโ”€โ”€ Repositories # Data access โ”‚ โ”œโ”€โ”€ Requests # Validated requests โ”‚ โ”œโ”€โ”€ Responses # Typed responses โ”‚ โ””โ”€โ”€ Services # Business logic โ”œโ”€โ”€ config # Configuration files โ”œโ”€โ”€ workers # RoadRunner workers (http, jobs, etc) โ”œโ”€โ”€ bootstrap # Kernel bootstrapping โ”œโ”€โ”€ public/index.php # Entry point (optional) ``` --- ๐Ÿ“ฆ Installation -------------- [](#-installation) ``` composer create-project beauty-framework/module-app beauty-framework cd beauty-framework cp .env.example .env make up # or make prod ``` --- โš™๏ธ Configuration (.env) ----------------------- [](#๏ธ-configuration-env) ``` APP_NAME=Beauty APP_ENV=local APP_VERSION=1.0 APP_TIMEZONE=UTC APP_LOCALE=en APP_DEBUG=true USE_DI_CACHE=true DB_CONNECTION=pgsql DB_HOST=database DB_PORT=5432 DB_DATABASE=my_db DB_USERNAME=root DB_PASSWORD=password CACHE_DRIVER=redis REDIS_HOST=redis REDIS_PORT=6379 ``` --- ๐Ÿง  CLI Commands -------------- [](#-cli-commands) CommandDescriptiongenerate:controllerGenerate controllergenerate:commandGenerate a new CLI commandgenerate:middlewareGenerate a new middlewaregenerate:requestGenerate a new requestgenerate:eventCreate a new eventgenerate:listenerCreate a new listenergenerate:jobCreate a new jobgenerate:moduleCreate a new module--- ๐Ÿณ Docker Setup (default) ------------------------ [](#-docker-setup-default) Beauty is designed to run **natively inside Docker**. By default, all services are containerized: ServiceImageNotesappphp:8.4-alpine + RRRoadRunner + CLI build targetsdbpostgres:16PostgreSQL 16redisredis:alpineRedis 7``` services: app: build: target: dev environment: PHP_IDE_CONFIG: "serverName=stage" restart: unless-stopped db: image: postgres:16 ports: - "5432:5432" redis: image: redis:alpine ports: - "6379:6379" ``` --- ๐Ÿ›  Makefile Commands ------------------- [](#-makefile-commands) CategoryCommandDescriptionStart`make up`Start the DEV environment`make prod`Start the PROD environmentStop`make stop`Stop all containers`make down`Remove all containers and volumes`make restart`Restart all containers`make restart-container CONTAINER=...`Restart a specific container`make stop-container CONTAINER=...`Stop a specific containerPHP`make php `Run php command inside the app container`make beauty `Run beauty CLI command inside the app containerTests`make test`Run PHPUnit testsComposer`make composer `Run composer command inside the app containerShell`make bash`Open bash shell inside the app containerLogs`make logs `View logs of specific containerDatabase`make psql`Access PostgreSQL CLICache`make redis`Access Redis CLI--- ๐Ÿ“š Documentation --------------- [](#-documentation) See [Documentation](https://beauty-framework.github.io/) page --- ๐Ÿ“ฆ Related Modules ----------------- [](#-related-modules) See full list of modules at [Documentation](https://beauty-framework.github.io/docs/Components/Modules%20and%20Components) page. --- ๐Ÿ“ TODO ------ [](#-todo) - ORM support (query builder + migrations) - `beauty/testing` package with framework-aware test harness - gRPC server module with RoadRunner integration - Job retries, delays, and failure handlers - OpenAPI/Swagger support - Full module documentation --- Welcome to Beauty Framework โ€” lean, fast, clean. Let's build some serious APIs โšก ### Health Score 29 โ€” LowBetter than 59% of packages Maintenance53 Moderate activity, may be stable Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 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 ~3 days Total 3 Last Release 323d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/068f8c26f06f513a9c38d2a01c4d90a85eae1125a5b9d14eae7059715be860e4?d=identicon)[m1n64](/maintainers/m1n64) --- Top Contributors [![m1n64](https://avatars.githubusercontent.com/u/24874264?v=4)](https://github.com/m1n64 "m1n64 (9 commits)") --- Tags modulesappbeauty ### Embed Badge ![Health badge](/badges/beauty-framework-module-app/health.svg) ``` [![Health](https://phpackages.com/badges/beauty-framework-module-app/health.svg)](https://phpackages.com/packages/beauty-framework-module-app) ``` ### Alternatives [nwidart/laravel-modules Laravel Module management 6.1k14.6M274](/packages/nwidart-laravel-modules)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[internachi/modular Modularize your Laravel apps 1.1k662.4k8](/packages/internachi-modular)[caffeinated/modules Laravel Modules 953661.5k9](/packages/caffeinated-modules)[pingpong/modules Laravel Modules 592188.7k13](/packages/pingpong-modules)[oxid-esales/oxideshop-ce This package contains OXID eShop CE source code. 2381.1M191](/packages/oxid-esales-oxideshop-ce) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)