fklavyenet/webblocks-cms

WebBlocks CMS

v1.36.0 2026-07-11 08:33 UTC

Requires

• php: ^8.4
• laravel/framework: ^13.0
• laravel/tinker: ^3.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/breeze: ^2.4
• laravel/pail: ^1.2.5
• laravel/pint: ^1.27
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^12.5.12

MIT

• Fklavyenet

• cms
• laravel
• blocks
• webblocks

Published on Packagist.org on 2026-07-11 08:34 UTC

README

A Laravel-native, block-based CMS for building and operating multiple sites from one admin.

WebBlocks CMS lets you build pages from reusable blocks and manage sites, media, navigation, and editorial publishing from a single admin. It ships with install-level tools for users, updates, backups, and site transfer — and an Internal Content API designed for AI and operator tooling.

It runs standalone, or alongside an existing Laravel app as an optional content layer. There is no Node/npm/Vite build step — CMS assets are static, so deployment stays simple on ordinary PHP hosting.

Positioning: WebBlocks CMS is best described as a Laravel-native operator CMS for multisite content operations, controlled public rendering, and AI-assisted page workflows — not a WordPress replacement or a headless delivery platform. See the Product Maturity Assessment.

Screenshots

A public page rendered from blocks — navigation, hero, and a feature grid, all editable in the admin.

The operator dashboard — publishing state, quick actions, and recent content at a glance.

Multisite page management with search, filters, block counts, and per-page actions.

Highlights

• 🧱 Block-based pages — reusable layouts, slots, and blocks; draft → review → publish workflow with page revisions and restore.
• 🌐 Multisite & multi-domain — locale-aware pages, per-site domains/aliases, themes, and site-scoped CSS/JS.
• 🌍 Localized operator UI — switch the authenticated admin interface between English, German, and Turkish directly from the topbar.
• 🖼️ Media & navigation — media library with responsive image variants and focal-point-aware crops, site-scoped navigation menus, shared slots for reusable block trees.
• ✉️ Native content blocks — spam-aware contact forms, site search, ratings and comments — no third-party embeds.
• 💾 Operations built in — backups & restore, export/import, site clone, site promotion, and in-app package-native updates.
• 🔌 Plugins — install plugin ZIPs (disabled by default, validated on upload), browse a plugin catalog with checksum-verified releases, plus a first-party WebBlocks Commerce plugin.
• 🤖 AI/operator API — a token-protected Internal Content API to discover contracts and validate/apply draft-first content plans.
• ⚡ Simple to run — Laravel 13, static assets, no frontend build chain.

See the Feature Inventory for the complete list.

Requirements

• PHP 8.4+
• Composer 2
• A database: SQLite, MySQL, or MariaDB
• A web server with the document root pointing at public/

Quick start

Try it in 60 seconds (Docker)

The fastest way to explore the CMS — no PHP, Composer, or database setup:

git clone https://github.com/fklavyenet/webblocks-cms.git
cd webblocks-cms
docker compose up --build

Then open http://localhost:8080 and sign in at /webadmin with [e-mail] / password. It installs itself (SQLite) on first boot. This is a demo, not a production setup.

Install locally with the browser wizard

Try it locally with the browser install wizard:

git clone https://github.com/fklavyenet/webblocks-cms.git
cd webblocks-cms
git remote set-url --push origin DISABLED   # installs are update consumers, not publishers

composer install
cp .env.example .env
php artisan key:generate
php artisan serve

Then open http://127.0.0.1:8000/install and follow the wizard. When it finishes, sign in at /webadmin.

Install into an existing Laravel app

composer require fklavyenet/webblocks-cms
php artisan webblocks:install --name="Admin User" --email="[e-mail]" --password="secret-password"

Both paths — and production notes — are covered in Installation.

Security: serve only public/ as the web root. .git and .github must never be web-reachable (a request to /.git/config should return 404). Prefer deploying a release artifact over a raw git clone in production.

Documentation

Start here:

• Getting Started · Installation · Core Concepts
• Feature Inventory · Multisite · Localization
• Editorial Workflow · Revisions · Users & Permissions
• Page Layouts · Block Type Contracts · Public Assets
• Media Image Variants
• Search · Contact Forms & Messages · Operations · Updates · Security

For AI / operator tooling:

• Internal Content API · API Discovery · AI Page Building Guide

For maintainers and contributors:

• Development Workflow · Architecture Decisions
• Detailed Project Reference — the former long-form README (feature notes, conventions, release details).

The full docs index lives in docs/.

Project status

WebBlocks CMS is actively developed and used in production on the maintainer's own sites. It is open source and free. See the Product Maturity Assessment for an honest, dated view of where it is strong (Laravel-native install/update, multisite, operator/AI workflows) and where it is still maturing (editor onboarding, ecosystem, buyer-facing docs).

Contributing

Contributions are welcome — see CONTRIBUTING.md and the Code of Conduct. Run composer test and composer format:test before opening a pull request.

Security

Read the Security guide for the security model and production hardening (web-root, update integrity, tokens, deployment). Please report vulnerabilities privately — see SECURITY.md. Do not open public issues for security reports.

License

WebBlocks CMS is open-source software licensed under the MIT license.

Trademark

"WebBlocks CMS" and its logos are the property of Fklavyenet, which operates https://fklavye.net. You may use, modify, and distribute the code under the MIT license, but you may not use the "WebBlocks CMS" name or logos for derived products without permission. If you fork or redistribute this project, remove or replace all branding.