PagibleAI CMS - Simple as Wordpress, the power of Contentful!
The easy, flexible and scalable API-first PagibleAI CMS package for Laravel.
Table of Contents
- About
- Features
- Tech Stack
- Architecture
- Project Structure
- Getting Started
- Selling access to restricted pages
- Configuration
- Maintenance
- Multi-domain
- Multi-tenancy
- MCP API
- Security
- Contributing
- What's Next
- License
- Acknowledgements
- Links
About
PagibleAI CMS is an API-first content management system that can be installed into any existing Laravel application. It combines the ease of use of WordPress with the structured content management capabilities of Contentful, powered by AI for content generation, image manipulation, and translation.
Whether you need a simple blog or a multi-tenant, multi-domain CMS serving millions of pages, PagibleAI scales to your needs — from a single SQLite-backed page to database clusters.
Features
- Structured Content - Manage structured content like in Contentful
- AI-Powered - AI generates/enhances drafts and images
- Hierarchical Pages - Hierarchical page tree with drag & drop
- Shared Content - Assign shared content to multiple pages
- Versioning - Save, publish, schedule and revert drafts
- Audit Trail - Full version history and audit trail
- Extensible Elements - Define new content elements in seconds
- JSON API - Extremely fast JSON frontend API
- GraphQL API - Versatile GraphQL admin API
- Multi-language - Multi-language support
- Multi-domain - Multi-domain routing
- Multi-tenancy - Multi-tenancy capable
- Importers - Importer for WordPress, etc.
- MCP API - 30+ tools for LLM-driven content management
- Full-text Search - Across SQLite, MySQL, PostgreSQL and SQL Server
- Paid Page Access - Sell subscriptions and one-time access through Stripe, Paddle, or Mollie
- Scalable - From single page with SQLite to millions of pages with DB clusters
- Open Source - Fully open source
Tech Stack
| Technology | Purpose |
|---|---|
| PHP 8.2+ | Backend language |
| Laravel 11.x / 12.x / 13.x | Web framework |
| Vue.js 3 | Admin panel frontend |
| Vuetify | Admin UI component library |
| Lighthouse | GraphQL API |
| Prism / Prisma PHP | AI/LLM integration |
| Vite | Frontend build tool |
Architecture
PagibleAI CMS is a modular monorepo split into focused sub-packages. Each package handles a specific concern and can be used independently:
- Core provides the data models (Page, Element, File, Version), multi-tenancy, permissions, and migrations
- Admin delivers the Vue.js-based admin panel with drag & drop page management
- GraphQL exposes the admin API via Lighthouse for content editing
- JSON:API provides a read-only frontend API for content delivery
- AI integrates LLM providers through Prism/Prisma PHP for content generation, image manipulation, and translation
- Search implements a custom Laravel Scout engine supporting FTS5 (SQLite), MATCH/AGAINST (MySQL), tsvector (PostgreSQL), and CONTAINSTABLE (SQL Server)
- MCP offers 30+ tools for LLM-driven content management
- Backup provides per-tenant backup and restore with media files, integrity verification, and cross-tenant support
- Import provides importers from external CMS platforms (WordPress, etc.)
- Cashier sells frontend page access through subscriptions or one-time payments using Stripe, Paddle, or Mollie
- Theme handles frontend rendering with Blade templates
- Themes contains high-quality frontend themes
Pages are organized as a nested set tree (using _lft/_rgt columns). All content changes are tracked as immutable version snapshots — editors see the latest draft while the public sees the published version. Caching is per-page with configurable duration.
Project Structure
pagible/
├── src/ Meta-package (install orchestrator + serve command)
├── core/ Models, permissions, tenancy, utilities, migrations
├── admin/ Vue.js admin panel (Vuetify + Vite)
├── ai/ AI features (Prism / Prisma PHP)
├── graphql/ GraphQL API (Lighthouse)
├── backup/ Backup and restore
├── cashier/ Shared payment-backed frontend access
├── cashier-*/ Stripe, Paddle, and Mollie Cashier adapters
├── import/ CMS importers (WordPress, etc.)
├── search/ Full-text search (Laravel Scout)
├── jsonapi/ Read-only JSON:API
├── mcp/ MCP server (30+ tools)
├── theme/ Frontend rendering (Blade templates)
├── themes/ Frontend themes (CSS)
├── tests/ Shared test infrastructure
├── config/ Configuration files
└── phpunit.xml Aggregated test runner
Getting Started
Prerequisites
- PHP 8.2 or higher
- Composer
- Node.js & npm (for admin panel development)
- A working Laravel 11.x, 12.x, or 13.x installation
Installation
If you don't have an existing Laravel application, create one first:
composer create-project laravel/laravel pagible
cd pagible
Then install PagibleAI CMS:
composer req aimeos/pagible
php artisan cms:install
php artisan migrate
Fresh Laravel applications contain a static public/robots.txt file. Web servers
serve that file before Laravel receives the request. If it contains custom rules,
first copy them into the robots.txt configuration element on the root page and
publish the change. Then remove the static file to enable Pagible's dynamic route:
rm public/robots.txt
The dynamic route serves the published rules together with the generated sitemap
and news sitemap URLs. Alternatively, configure the web server to pass
/robots.txt to Laravel even when the static file exists.
Now, adapt the .env file of your application and change the APP_URL setting to your domain. If you are using php artisan serve for testing, add the port of the internal web server (APP_URL=http://localhost:8000). Otherwise, the uploading files will fail because they wouldn't be loaded!
Add a line in the "post-update-cmd" section of your composer.json file to update the admin backend files after each update:
"post-update-cmd": [
"@php artisan vendor:publish --force --tag=cms-admin --tag=cms-graphql",
"@php artisan vendor:publish --tag=cms-theme",
"@php artisan migrate",
...
],
Authorization
To allow users to edit CMS content or to create a new users if they don't exist yet, you can use the cms:user command (replace the e-mail address by the users one):
php artisan cms:user -e [email protected]
This adds admin privileges for the specified user. For more information regarding authorization and permissions, please have a look into the authorization and permission page.
The CMS admin backend is available at (replace "mydomain.tld" with your own one):
http://mydomain.tld/cmsadmin
Selling access to restricted pages
Install exactly one Pagible Cashier provider in the Laravel application that already contains Pagible CMS:
composer require aimeos/pagible-cashier-stripe
# or: aimeos/pagible-cashier-paddle
# or: aimeos/pagible-cashier-mollie
php artisan cms:install:cashier
For Stripe, an interactive installer offers to create the webhook when
APP_URL, STRIPE_KEY, and STRIPE_SECRET are ready. Automated installations
must opt in with --webhook.
Add Pagible's CashierAccess trait and the selected provider's Billable trait
to the application user model. Then configure the provider credentials and
verified webhooks, define a frontend access value such as premium-members, and
run the local readiness check:
php artisan cms:cashier:check
Use that same access value in both places in the CMS admin:
- Add a
pricingelement to a public sales page and selectpremium-membersas the package's frontend access role. Add a subscription price, a one-time price, or both, then publish the pricing content. - Open the page being sold, choose Access, select Restricted, add
premium-members, and apply the change.
Verified payment webhooks grant and revoke the role automatically. A successful one-time payment grants permanent access unless it is fully refunded or charged back. A subscription grants access through its provider-confirmed paid period. See the Pagible Cashier guide for the user-model example, access-catalog setup, provider-specific price fields, webhook configuration, private files, cancellations, and an end-to-end checklist.
Configuration
File uploads use the Laravel dis