README

Liberu CMS

Open-Source Content Management — Built with Laravel 12, Filament 5, Livewire 4, and PHP 8.5

About Liberu CMS

Liberu CMS is a powerful, open-source content management system built on the latest versions of Laravel 12, PHP 8.5, Filament 5, and Livewire 4. Designed to be fast, flexible, and developer-friendly, it gives content creators and administrators an intuitive platform for building and managing modern digital experiences — from blogs and landing pages to full enterprise websites.

Whether you're a solo creator or a team managing large-scale digital content, Liberu CMS delivers the tools and structure you need, backed by a clean codebase and an active open-source community.

Key Features

User-Friendly Content Creation: An intuitive interface for creating and managing articles, multimedia content, and dynamic pages — no technical expertise required.
Real-Time Livewire Interactions: Built with Livewire 4, Liberu CMS delivers seamless, reactive user experiences — edit, preview, and publish without full page reloads.
Powerful Filament 5 Admin Panel: The Filament 5-powered admin panel provides a rich, customisable interface for managing users, roles, settings, and the entire content ecosystem.
Customisable Templates: Tailor your site's appearance with flexible templates. Build unique, brand-aligned websites using the CMS's theming and layout tools.
Role-Based Access Control: Granular permission management via Filament Shield, ensuring the right people have access to the right content and settings.
Menu Builder: Easily create and manage navigation menus across your site using the integrated Filament Menu Builder.
Scalability and Performance: Suitable for personal blogs through to enterprise-scale websites. The modern Laravel 12 foundation ensures excellent performance and reliability.
Docker & Laravel Sail Support: Spin up a full development environment in minutes using Docker or Laravel Sail.

Our Projects

Installation

Requirements

PHP 8.5+
Composer
Node.js 22+
A supported database (MySQL, PostgreSQL, SQLite)

Option 1: Automated Script (Recommended)

The easiest way to get started is to run the included setup script from the command line. It will guide you through copying your environment file, installing dependencies, running migrations, and seeding the database.

git clone https://github.com/liberu-cms/cms-laravel.git
cd cms-laravel
./setup.sh

Note: On Linux/macOS, run the script as you would any shell script in the terminal. On Windows, use Git Bash or WSL.

The script will prompt you to confirm each step, including whether to overwrite an existing .env file. If you already have a .env configured, answer n when prompted.

Note: The script runs database seeders automatically. Ensure your database credentials are correct in .env before proceeding.

Option 2: Manual Installation

If you prefer to install manually, run the following commands:

git clone https://github.com/liberu-cms/cms-laravel.git
cd cms-laravel
cp .env.example .env
composer install
php artisan key:generate
php artisan migrate --seed
npm install
npm run build
php artisan serve

Ensure your .env file is configured with your database connection details before running migrations.

Option 3: Docker / Laravel Sail

You can also run Liberu CMS using Docker or the included Laravel Sail configuration.

Using Docker:

docker build -t cms-laravel .
docker run -p 8000:8000 cms-laravel

Using Laravel Sail:

./vendor/bin/sail up

Once running, access the application at http://localhost. For more details, see the Laravel Sail documentation.

Graphical Installer

For users who prefer a GUI-based setup, a graphical installer is available. Download and run it from the Releases page — it walks you through environment configuration and installation without needing to use the command line.

Contributing

Contributions are warmly welcome! Whether you want to fix a bug, add a feature, improve documentation, or raise an issue, your involvement helps make Liberu CMS better for everyone.

Pull Request Process:

Fork the repository and create a new branch for your changes.
Make your changes with clear, descriptive commit messages.
Ensure tests pass by running php artisan test.
Submit a pull request to the main branch with a clear description of what you've changed and why.
The maintainers will review your PR and may request changes before merging.

If you're not comfortable writing code, raising a GitHub Issue is equally valuable — it helps us track bugs, ideas, and improvements.

We believe in an inclusive, collaborative community where every contribution is respected and appreciated.

License

Liberu CMS is open source, licensed under the MIT License.

The MIT license is one of the most permissive open-source licenses available. It means you are free to:

Use the software for any purpose — personal, commercial, or otherwise
Modify the source code to suit your needs
Distribute copies of the software, with or without your modifications
Integrate it into proprietary products without requiring you to open-source your own code

The only requirement is that the original copyright notice and licence text are included with any distribution.

This permissive approach makes Liberu CMS an ideal foundation for both individual projects and commercial products, with no hidden costs or licensing restrictions.

liberu-cms / cms-laravel

Maintainers

Package info

Fund package maintenance!

Statistics

Security