PHPackages monkeyscloud/monkeyscms - 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. monkeyscloud/monkeyscms ActiveProject[Framework](/categories/framework) monkeyscloud/monkeyscms ======================= A modern, code-first CMS built on MonkeysLegion v2 โ€” visual page building, decoupled API, ML templates 1.0.x-dev(1mo ago)40MITPHPPHP ^8.4CI failing Since May 11Pushed 1mo ago1 watchersCompare [ Source](https://github.com/MonkeysCloud/MonkeysCMS)[ Packagist](https://packagist.org/packages/monkeyscloud/monkeyscms)[ Docs](https://github.com/MonkeysCloud/MonkeysCMS)[ RSS](/packages/monkeyscloud-monkeyscms/feed)WikiDiscussions main Synced today READMEChangelogDependencies (11)Versions (2)Used By (0) MonkeysCMS v1.0 =============== [](#monkeyscms-v10) [![PHP Version](https://camo.githubusercontent.com/d6cefa91b9fa29b5f2f840c25f8f6e94cc663f0a21793fe0f7adb597a3a006ff/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e342532422d3838393242462e737667)](https://php.net)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Framework](https://camo.githubusercontent.com/85489f8c5c30bf401d0c24bfa25d45b49e2229cfb8bc20e536803740076c2a4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6672616d65776f726b2d4d6f6e6b6579734c6567696f6e25323076322d3633363666312e737667)](https://github.com/MonkeysCloud/monkeyslegion) **A modern, headless CMS built on PHP 8.4 and the MonkeysLegion framework.** MonkeysCMS is a content management system with a theme engine, visual page builder (Mosaic), decoupled JSON:API, and MLC-driven database migrations โ€” designed for both traditional server-rendered sites and headless/decoupled architectures. --- โœจ Key Features -------------- [](#-key-features) FeatureDescription**Content Management**Nodes, content types, dynamic fields, revisions, taxonomy, menus**Mosaic Page Builder**Visual block-based editor with drag-drop layout composition**Theme Engine**Tiered themes (core/contrib/custom), full inheritance chain, global libraries**JSON:API**Decoupled JSON:API 1.1 endpoint with filtering, pagination, relationships**MLC Migrations**Declarative schema in `.mlc` config files โ€” no raw SQL**Admin UI**Full admin interface with dashboard, content CRUD, media, settings, appearance**Installer Wizard**6-step web-based installer for zero-config bootstrap--- ๐Ÿš€ Quick Start ------------- [](#-quick-start) ``` git clone git@github.com:MonkeysCloud/MonkeysCMS.git cd MonkeysCMS composer install cp .env.example .env php ml key:generate composer serve # โ†’ http://127.0.0.1:8000/install ``` --- ๐Ÿ“ Project Structure ------------------- [](#-project-structure) ``` MonkeysCMS/ โ”œโ”€โ”€ app/ โ”‚ โ”œโ”€โ”€ Cms/ # CMS core (App\Cms namespace) โ”‚ โ”‚ โ”œโ”€โ”€ Block/ # Mosaic block types & registry โ”‚ โ”‚ โ”œโ”€โ”€ Content/ # Nodes, content types, fields, revisions โ”‚ โ”‚ โ”œโ”€โ”€ Controller/ # Admin, Frontend, API, Installer controllers โ”‚ โ”‚ โ”œโ”€โ”€ Database/ # MigrationManager, SchemaBuilder, MigrationConfig โ”‚ โ”‚ โ”œโ”€โ”€ JsonApi/ # JSON:API 1.1 formatter & response builder โ”‚ โ”‚ โ”œโ”€โ”€ Media/ # Media entity, repository, service โ”‚ โ”‚ โ”œโ”€โ”€ Menu/ # Menu entity, repository, builder โ”‚ โ”‚ โ”œโ”€โ”€ Middleware/ # CORS, admin access, API auth โ”‚ โ”‚ โ”œโ”€โ”€ Mosaic/ # Page builder renderer & services โ”‚ โ”‚ โ”œโ”€โ”€ Provider/ # DI service providers โ”‚ โ”‚ โ”œโ”€โ”€ Settings/ # Site settings entity & repository โ”‚ โ”‚ โ”œโ”€โ”€ Taxonomy/ # Vocabularies, terms, tagging โ”‚ โ”‚ โ”œโ”€โ”€ Theme/ # ThemeManager, ThemeInfo, ThemeLibrary โ”‚ โ”‚ โ””โ”€โ”€ User/ # CMS user entity & repository โ”‚ โ”œโ”€โ”€ Controller/ # Framework-level controllers โ”‚ โ”œโ”€โ”€ Dto/ # Request DTOs with validation โ”‚ โ”œโ”€โ”€ Entity/ # Framework entities โ”‚ โ””โ”€โ”€ Service/ # Business logic โ”œโ”€โ”€ config/ โ”‚ โ”œโ”€โ”€ app.mlc # Application settings โ”‚ โ”œโ”€โ”€ database.mlc # Database connection โ”‚ โ”œโ”€โ”€ libraries.mlc # Global CSS/JS libraries โ”‚ โ”œโ”€โ”€ middleware.mlc # Middleware pipeline โ”‚ โ””โ”€โ”€ *.mlc # Other config (auth, cache, cors, etc.) โ”œโ”€โ”€ database/ โ”‚ โ””โ”€โ”€ migrations.mlc # Migration registry โ”œโ”€โ”€ resources/ โ”‚ โ”œโ”€โ”€ css/base/ # Global base CSS (variables, reset, grid, typography) โ”‚ โ”œโ”€โ”€ css/components/ # Shared component CSS (forms, buttons, cards, etc.) โ”‚ โ”œโ”€โ”€ migrations/ # MLC schema definitions โ”‚ โ””โ”€โ”€ views/ # Fallback templates โ”œโ”€โ”€ themes/ โ”‚ โ”œโ”€โ”€ core/ # Built-in themes (shipped with CMS) โ”‚ โ”‚ โ”œโ”€โ”€ admin/ # Admin base theme โ”‚ โ”‚ โ””โ”€โ”€ front/ # Frontend base theme โ”‚ โ”œโ”€โ”€ contrib/ # Community/third-party themes โ”‚ โ”‚ โ”œโ”€โ”€ admin_starter/ # Example admin child theme โ”‚ โ”‚ โ””โ”€โ”€ starter/ # Example frontend child theme โ”‚ โ””โ”€โ”€ custom/ # User-created themes โ”œโ”€โ”€ public/ โ”‚ โ””โ”€โ”€ index.php # Entry point โ””โ”€โ”€ tests/ # PHPUnit test suites ``` --- ๐ŸŽจ Theme System -------------- [](#-theme-system) MonkeysCMS uses a tiered, inheritable theme system inspired by modern CMS architecture. Themes are auto-discovered from three directories: ``` themes/ โ”œโ”€โ”€ core/ โ† Base themes shipped with CMS (lowest priority) โ”œโ”€โ”€ contrib/ โ† Community/installable themes โ””โ”€โ”€ custom/ โ† User-created themes (highest priority) ``` ### How Themes Work [](#how-themes-work) Each theme contains a `theme.mlc` configuration: ``` theme { name = "my_theme" label = "My Custom Theme" version = "1.0.0" type = "frontend" # "frontend" or "admin" base_theme = "front" # Inherit from parent theme # Global libraries to attach (from config/libraries.mlc) libraries = ["core/modals", "core/alerts"] # Theme-specific assets (loaded after parent's) assets { css = ["css/my_theme.css"] js = ["js/my_theme.js"] } } ``` ### Theme Inheritance [](#theme-inheritance) Child themes inherit **everything** from their parent: - **Views & components** โ€” resolved through full chain (child โ†’ parent โ†’ grandparent โ†’ base) - **CSS/JS assets** โ€” parent loaded first, child loaded last (can override via CSS variables) - **Regions** โ€” inherited if not redefined - **Libraries** โ€” accumulated from the entire chain ``` my_theme โ†’ front (base) โ†“ inherits views, components, regions, libraries โ†“ only overrides what it changes ``` ### Global Libraries [](#global-libraries) Shared CSS/JS defined in `config/libraries.mlc` โ€” themes attach them without reproducing: ``` library "core/base" { css = ["resources/css/base/variables.css", "resources/css/base/reset.css", ...] weight = -100 required = true # Always loaded } library "core/forms" { css = ["resources/css/components/forms.css"] weight = -50 # Loaded when a theme requests it } ``` **14 built-in libraries**: core/base, core/monkeysjs, core/forms, core/buttons, core/cards, core/tables, core/alerts, core/modals, core/navigation, core/media, admin/toolbar, admin/editor, front/responsive, front/animations. ### Installing a Theme [](#installing-a-theme) 1. Place theme folder in `themes/contrib/` or `themes/custom/` 2. Add a `theme.mlc` config file 3. Set `base_theme` to inherit from an existing theme 4. Activate it in **Admin โ†’ Appearance** ### Admin Theme Selection [](#admin-theme-selection) Users choose both frontend and admin themes independently via **Admin โ†’ Appearance**. Admin child themes work identically โ€” set `type = "admin"` and `base_theme = "admin"`. --- ๐Ÿงฑ Mosaic Page Builder --------------------- [](#-mosaic-page-builder) Mosaic is a visual, block-based page builder. Content editors compose pages using draggable blocks: Block TypeDescription`hero`Full-width hero section with background, title, CTA`richtext`WYSIWYG rich text content`image`Single image with caption and alt text`gallery`Image gallery with grid/carousel layout`cta`Call-to-action with heading, text, buttons`columns`Multi-column layout (2/3/4 columns)`video`Embedded video (YouTube, Vimeo, self-hosted)`accordion`Collapsible FAQ/content sections`form`Embedded form builderBlocks are stored as JSON and rendered through the theme's component system. --- ๐Ÿ—„๏ธ Database Migrations ---------------------- [](#๏ธ-database-migrations) MonkeysCMS uses **MLC-based declarative schema** instead of raw SQL: ``` # resources/migrations/core_schema.mlc schema { table "cms_roles" { id { type = "unsignedBigInt", autoIncrement = true, primary = true } machine_name { type = "string", length = 64, notNull = true } label { type = "string", length = 128, notNull = true } permissions { type = "json", notNull = true, default = "[]" } } seed "cms_roles" { row { machine_name = "admin", label = "Administrator", permissions = "[\"*\"]" } row { machine_name = "editor", label = "Editor" } row { machine_name = "viewer", label = "Viewer" } } } ``` **Migration registry** (`database/migrations.mlc`) manages ordering and dependencies: ``` migration "core_schema" { file = "resources/migrations/core_schema.mlc" module = "core" version = "1.0.0" } ``` **16 core tables**: roles, users, user\_roles, content\_types, field\_definitions, nodes, node\_fields, node\_revisions, media, taxonomy\_vocabularies, taxonomy\_terms, node\_terms, menus, menu\_items, blocks, settings. --- ๐Ÿ”Œ JSON:API ---------- [](#-jsonapi) Decoupled JSON:API 1.1 endpoint for headless architectures: ``` GET /api/v1/nodes?filter[content_type]=article&page[limit]=10 GET /api/v1/nodes/{id} POST /api/v1/nodes PUT /api/v1/nodes/{id} DELETE /api/v1/nodes/{id} ``` Response format: ``` { "jsonapi": { "version": "1.1" }, "data": [{ "type": "nodes", "id": "1", "attributes": { "title": "Hello World", "slug": "hello-world", "status": "published" }, "relationships": { "content_type": { "data": { "type": "content_types", "id": "article" } } } }], "meta": { "total": 42 }, "links": { "self": "/api/v1/nodes?page[offset]=0", "next": "..." } } ``` --- ๐Ÿ› ๏ธ Admin Interface ------------------ [](#๏ธ-admin-interface) The admin theme provides a complete management UI: PageDescription**Dashboard**Stats cards, content overview, quick actions, recent content**Content**List, filter, search, bulk actions, create/edit with dynamic fields**Media**Grid/list view, drag-drop upload, file management**Menus**Menu builder with drag-drop ordering**Taxonomy**Vocabularies and terms management**Blocks**Block type registry**Appearance**Theme selector (frontend + admin), global libraries overview**Settings**General, content, media, API, and cache settings with tabs**Content Types**Define content types and field definitions**Users**User management with roles--- โš™๏ธ Configuration ---------------- [](#๏ธ-configuration) All config uses `.mlc` format (MonkeysLegion Config): ``` # config/app.mlc app { name = ${APP_NAME:"MonkeysCMS"} env = ${APP_ENV:production} debug = ${APP_DEBUG:false} url = ${APP_URL:http://localhost:8000} key = ${APP_KEY} timezone = "UTC" } ``` --- ๐Ÿ“ฆ Built on MonkeysLegion v2 --------------------------- [](#-built-on-monkeyslegion-v2) MonkeysCMS is built on the [MonkeysLegion](https://github.com/MonkeysCloud/monkeyslegion) PHP 8.4 framework: - **Attribute routing** โ€” `#[Route]`, `#[RoutePrefix]`, `#[Middleware]` - **PHP 8.4 property hooks** โ€” entities with validation on set - **PSR-7/PSR-15** โ€” standards-compliant HTTP pipeline - **PSR-11 DI container** โ€” `#[Singleton]`, auto-discovery - **Template engine** โ€” `.ml.php` templates with Blade-like syntax - **MLC config** โ€” type-safe configuration with environment interpolation --- ๐Ÿงช Testing --------- [](#-testing) ``` composer test # All tests composer test:unit # Unit tests composer test:feature # Feature tests ``` --- ๐Ÿ“œ License --------- [](#-license) MIT License โ€” see [LICENSE](LICENSE) for details. --- **MonkeysCMS** โ€” Built with ๐Ÿ’ by [MonkeysCloud](https://github.com/MonkeysCloud) ### Health Score 36 โ€” LowBetter than 79% of packages Maintenance90 Actively maintained with recent releases Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity37 Early-stage or recently created project 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 Unknown Total 1 Last Release 53d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2913369?v=4)[Jorge Peraza](/maintainers/yorchperaza)[@yorchperaza](https://github.com/yorchperaza) --- Top Contributors [![yorchperaza](https://avatars.githubusercontent.com/u/2913369?v=4)](https://github.com/yorchperaza "yorchperaza (28 commits)") --- Tags cmscms-frameworkcontent-management-systemmonkeyslegionphppsr-7phpapiframeworkpsr-15cmscontent managementpage buildermonkeyslegiondecoupled ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/monkeyscloud-monkeyscms/health.svg) ``` [![Health](https://phpackages.com/badges/monkeyscloud-monkeyscms/health.svg)](https://phpackages.com/packages/monkeyscloud-monkeyscms) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[cakephp/cakephp The CakePHP framework 8.9k19.5M1.8k](/packages/cakephp-cakephp) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)