streats22 / laragrape
A Laravel package for GrapesJS + Filament block builder integration.
1.1.0
2025-07-04 21:06 UTC
Requires
- php: ^8.2
- filament/filament: ^3.0
- illuminate/support: ^10.0|^11.0|^12.0
- maatwebsite/excel: ^3.1
- wiebenieuwenhuis/filament-code-editor: ^1.2
Requires (Dev)
- fakerphp/faker: ^1.23
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.6
- phpunit/phpunit: ^11.5.3
README
LaraGrape combines the visual power of GrapesJS with the modern admin experience of Filament to deliver a seamless, developer-friendly CMS-like system for Laravel.
🚀 Getting Started with LaraGrape
LaraGrape requires laravel follow the steps below after you have a default laravel setup.
After installing the package, follow these steps to get up and running:
- Install the package:
composer require laragrape/laragrape
if that doesn't work try.composer require streats22/laragrape
- Run the setup command to publish config, views, migrations, and (optionally) run migrations:
php artisan laragrape:setup --migrate
- Create a Filament admin user:
php artisan make:filament-user
Follow the prompts to set up your admin credentials. - Install Filament admin panel:
php artisan filament:install --panel
- (Optional) Build frontend assets if your project uses them:
npm install npm run build
- Serve your application:
php artisan serve
- Visit
/admin
to access the Filament admin panel. - Visit the frontend (e.g.,
/
) to see your site.
- Visit
🛠️ LaraGrape Setup Command Options
The laragrape:setup
command provides several options for customizing your setup process:
Usage:
php artisan laragrape:setup [options]
Available options:
Option | Description |
---|---|
--migrate | Run migrations after publishing |
--seed | Run seeders after publishing |
--force | Overwrite existing published files |
--publish-config | Only publish config |
--publish-views | Only publish views |
--publish-migrations | Only publish migrations |
--publish-seeders | Only publish seeders |
--all | Publish everything, migrate, and seed |
Examples:
- Publish everything and run migrations:
php artisan laragrape:setup --all
- Only publish views:
php artisan laragrape:setup --publish-views
- Publish config and run migrations:
php artisan laragrape:setup --publish-config --migrate
What's Next?
- Customize blocks, views, and settings:
All package views and blocks are publishable and can be overridden in your app. - Check the published config file at
config/laragrape.php
for customization options. - Explore the admin panel to create and manage pages, blocks, and site settings.
🚀 Why Add LaraGrape to Your Laravel Project?
- No More Static Pages: Empower your users (or yourself) to visually build and manage pages with drag-and-drop ease—no code required!
- Frontend & Backend Editing: Enjoy the flexibility of a true WYSIWYG editor (GrapesJS) for the frontend, and robust content management with Filament on the backend.
- Instant CMS Functionality: Get a full-featured, extensible CMS experience without leaving the Laravel ecosystem.
- Rapid Prototyping: Build, preview, and publish pages in minutes—perfect for agencies, startups, and internal tools.
- Custom Blocks & Extensibility: Easily create and manage custom blocks, layouts, and templates to fit any project's needs.
- SEO & Responsive Ready: Out-of-the-box SEO features and mobile-friendly design ensure your content looks great everywhere.
- Open Source & Actively Maintained: Built for the community, with regular updates and support.
📦 Installation
composer require laragrape/laragrape
⚡ Quick Start
- Install the package:
composer require laragrape/laragrape
- Run the setup command:
php artisan laragrape:setup --migrate
- Create a Filament admin user:
php artisan make:filament-user
- Install Filament admin panel:
php artisan filament:install --panel
- (Optional) Build frontend assets:
npm install && npm run build
- Serve your app and visit
/admin
and the frontend!
📚 Documentation
- Package Setup Guide
- Dynamic Block System
- Modular Component System
- Custom Block Builder & Site Settings
LaraGrape: The easiest way to add a modern, visual CMS to your Laravel project—without sacrificing developer control.