Skip to content
MiranSalehiPublic

About

Laravel + Filament 5 CMS foundation: visual page builder, installable plugins & themes, hooks, menus, media library, settings, translations, and a Super Admin console. Composer package for building content-driven sites and extensible admin panels without forking Laravel.

Resources

Security policy

Stars

110 stars

Watchers

3 watching

Forks

Repository files navigation

MKSine

The Laravel + Filament 4 / 5 CMS foundation — build content sites, page builders, and plugin ecosystems without fighting your admin panel.

MKSine page builder: preview on tablet and mobile, edit a block, see it live

Latest Version Total Downloads License

Quick Install · Features · Documentation


Why MKSine

Filament gives you a great admin panel. MKSine gives you the CMS layer on top of it: content types, a visual page builder, installable plugins with real lifecycle management, themes, menus, hooks, and a settings system — all built the Filament way, so it feels native instead of bolted on.

If you've ever built a "simple site" in Laravel and ended up hand-rolling pages, blocks, menus, and a plugin system from scratch — this is that groundwork, already done.


Quick install

composer require miran/mksine
php artisan filament:install --panels
php artisan mksine:install --migrate

mksine:install registers MksinePlugin on the admin panel, removes Laravel's default / route, migrates, activates the default theme and asks for an admin account. Shared hosting without SSH: build a zip with php artisan mks:release-archive --layout=split.

Full installation guide → docs/01-installation.md


Features

🧱 Page Builder

Opt-in visual block editor for marketing pages. Compose typed blocks (hero, columns, cards, CTA, theme sections, and more), edit them in a side panel and see the canvas update live, preview on desktop, tablet, and mobile, and start from templates. Undo/redo and page revisions are built in. The tree is stored as JSON, rendered by the active theme, and also available as a JSON document API for headless front ends.

📖 Concepts · Creating a block · Rendering · Headless JSON


🧩 Plugins

Drop-in extensions under plugins/{id}/ with full lifecycle — install, activate, deactivate, roll back — from a ZIP upload, filesystem discovery, or the MKSine marketplace. Filament autoloading, migrations, assets, and hook listeners are handled for you, and every action is logged. No forking core to extend the system.

Plugin manager

📖 Concepts · Build a plugin (golden path) · Lifecycle


🎨 Themes

Package themes and project themes (themes/{id}/). One active theme controls storefront Blade views and published CSS/JS — upload, discover, install from the marketplace, activate, roll back, and edit custom CSS/JS directly from the panel.

Theme manager

📖 Concepts · Creating a theme


🧭 Menus

Visual menu builder: drag to reorder, drag right to nest, and add pages, posts, categories, tags, or custom links. Assign menus to theme locations like header and footer.

Menu builder: drag to reorder and nest

📖 Concepts · Locations


🪝 Hooks

Two families: discovery hooks (class listeners synced to DB, toggleable in admin) and runtime hooks (closures in boot(), with named handlers you can remove). Extend forms, tables, events, storefront content, and Filament resources — without touching core.

📖 Concepts · Two families overview


📁 Content & Media

Manage pages, posts, categories, tags, and moderated comments from the Filament admin, with an advisory SEO analysis (focus keyphrase, meta title and description) on pages, posts, categories, and tags. A central media library handles files with image optimization, thumbnails, and a MediaPicker for forms — with reorderable galleries — and attaches files polymorphically to any model.

Media library

📖 Architecture · Media library guide · SEO analysis


⚙️ Settings & admin menu

Site-wide settings with core tabs (General, Locations & addresses, Permalinks) plus plugin tabs registered dynamically via SettingsTabManager — no editing the settings page class required. Choose the Gregorian or Jalali calendar for every date in the panel.

Settings

The Admin menu editor lets a Super Admin hide, move, reorder, and rename sidebar items and groups without touching code.

Admin menu editor

📖 Adding settings tabs · Admin menu


🌐 Translations

Edit application, plugin, and theme translation files directly from the admin — pick language, source, and file; saving writes to the source and vendor publish path.

Translations editor

📖 Translations workflow


💻 Admin Console

Super Admin only. Run allowlisted php artisan … and composer … commands from the panel with live, colored output, autocomplete, and keyboard shortcuts. Every run is saved to the history. Long-running workers can keep running in the background, and a status panel shows whether the scheduler and queue workers are alive, how many jobs are waiting or failed, and which scheduled tasks run next.

Admin console: autocomplete, live output, scheduler and queue status

📖 Commands reference


🔐 Auth & permissions

Filament Shield integration, a super admin role, and optional user subclass requirements for plugins that need them.

📖 User subclass · Shield and policies


Operations & deployment

Deployment guides, release ZIP packaging, ZIP-based updates, and troubleshooting — all documented for production use, not just local dev.

📖 Deployment · Troubleshooting · Upgrade guide


Full documentation

This overview covers the surface. For architecture decisions, guides, and reference docs, see the full index:

👉 https://github.com/MiranSalehi/mksine/tree/main/docs


If MKSine saves you time, a ⭐ on the repo helps other Laravel/Filament developers find it.

About

Laravel + Filament 5 CMS foundation: visual page builder, installable plugins & themes, hooks, menus, media library, settings, translations, and a Super Admin console. Composer package for building content-driven sites and extensible admin panels without forking Laravel.

Resources

Security policy

Stars

110 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages