PHPackages                             streats22/laragrape - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. streats22/laragrape

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

streats22/laragrape
===================

A Laravel package for GrapesJS + Filament block builder integration.

1.5.0(1mo ago)51412[4 PRs](https://github.com/Streats22/LaraGrapePackage/pulls)MITPHPPHP ^8.3CI passing

Since Jul 2Pushed 2w agoCompare

[ Source](https://github.com/Streats22/LaraGrapePackage)[ Packagist](https://packagist.org/packages/streats22/laragrape)[ RSS](/packages/streats22-laragrape/feed)WikiDiscussions main Synced today

READMEChangelog (7)Dependencies (21)Versions (22)Used By (0)

🍇 LaraGrape: The Ultimate Laravel Page Builder Package
======================================================

[](#-laragrape-the-ultimate-laravel-page-builder-package)

**LaraGrape** combines the visual power of [GrapesJS](https://grapesjs.com/) with the modern admin experience of [Filament](https://filamentphp.com/) to deliver a seamless, developer-friendly CMS-like system for Laravel.

---

🚀 Quick Start
-------------

[](#-quick-start)

### 1. Install the Package

[](#1-install-the-package)

```
composer require streats22/laragrape
```

### 2. Run the Setup Command

[](#2-run-the-setup-command)

```
php artisan laragrape:setup --all
```

### 3. Create Admin User

[](#3-create-admin-user)

```
php artisan make:filament-user
```

### 4. Build Frontend Assets

[](#4-build-frontend-assets)

```
npm install
npm run build
```

### 5. Start Your Application

[](#5-start-your-application)

```
php artisan serve
```

- **Admin Panel**: Visit `/admin` to access Filament
- **Frontend**: Visit `/` to see your site

---

✨ Features
----------

[](#-features)

### 🎨 Visual Page Builder

[](#-visual-page-builder)

- **GrapesJS Integration**: Drag-and-drop page building
- **Pre-built Blocks**: Hero sections, cards, forms, and more
- **Responsive Design**: Mobile-first approach with Tailwind CSS
- **Live Preview**: See changes in real-time

### 🛠️ Admin Panel

[](#️-admin-panel)

- **Filament 5**: Modern, responsive admin interface
- **Page Management**: Create, edit, and publish pages
- **Custom Blocks**: Build and manage reusable components
- **Site Settings**: Configure header, footer, and general settings
- **Tailwind Config**: Dynamic theme management

### 🔧 Developer Experience

[](#-developer-experience)

- **Laravel 12+ Compatible**: Built for modern Laravel
- **Alpine.js**: Lightweight JavaScript framework
- **Modular Architecture**: Clean, maintainable code structure
- **Extensible**: Easy to customize and extend

---

📦 What's Included
-----------------

[](#-whats-included)

### Core Components

[](#core-components)

- ✅ **Pages System**: Full CRUD with GrapesJS integration
- ✅ **Custom Blocks**: Visual block builder with live preview
- ✅ **Site Settings**: Comprehensive configuration management
- ✅ **Tailwind Config**: Dynamic theme system
- ✅ **Admin Panel**: Filament-based administration
- ✅ **Frontend Layout**: Responsive, SEO-optimized templates

### Database Tables

[](#database-tables)

- `pages` - Page content and metadata
- `custom_blocks` - User-created blocks
- `site_settings` - Site configuration
- `tailwind_configs` - Theme configurations

### Filament Resources

[](#filament-resources)

- **PageResource**: Page management with visual editor
- **CustomBlockResource**: Block builder and management
- **SiteSettingsResource**: Site configuration
- **TailwindConfigResource**: Theme management

---

🛠️ Setup Command Options
------------------------

[](#️-setup-command-options)

The `laragrape:setup` command provides comprehensive setup with error handling:

```
php artisan laragrape:setup [options]
```

### Available Options

[](#available-options)

OptionDescription`--all`Complete setup (publish, migrate, seed)`--migrate`Run migrations after publishing`--seed`Run seeders after publishing`--force`Overwrite existing files### Examples

[](#examples)

```
# Complete setup
php artisan laragrape:setup --all

# Publish only
php artisan laragrape:setup

# Publish and migrate
php artisan laragrape:setup --migrate
```

---

🔄 Update Command
----------------

[](#-update-command)

The `laragrape:update` command allows you to selectively update LaraGrape components without doing a full installation:

```
php artisan laragrape:update [options]
```

### Available Options

[](#available-options-1)

OptionDescription`--all`Update all components`--config`Update configuration files only`--views`Update view files only`--migrations`Update migration files only`--filament`Update Filament components only`--assets`Update frontend assets only`--controllers`Update controllers only`--services`Update services only`--routes`Update routes only`--models`Update models only`--seeders`Update seeders only`--console`Update console commands only`--run-migrate`Run migrations after updating`--run-seed`Run seeders after updating`--force`Overwrite existing files without asking### Examples

[](#examples-1)

```
# Interactive update (select components from menu)
php artisan laragrape:update

# Update all components
php artisan laragrape:update --all

# Update specific components
php artisan laragrape:update --filament --assets

# Update with database operations
php artisan laragrape:update --all --run-migrate
php artisan laragrape:update --all --run-seed
php artisan laragrape:update --all --run-migrate --run-seed

# Force update without confirmation
php artisan laragrape:update --all --force
```

**Note**: The update command doesn't install Filament (assumes it's already installed). Use the setup command for initial installation.

---

🎯 Key Features
--------------

[](#-key-features)

### Visual Page Builder

[](#visual-page-builder)

- **Drag &amp; Drop**: Intuitive block-based editing
- **Pre-built Blocks**: 20+ ready-to-use components
- **Custom Blocks**: Create your own reusable components
- **Responsive**: Mobile-first design approach
- **Live Preview**: Real-time editing experience

### Admin Panel

[](#admin-panel)

- **Modern Interface**: Filament 5 admin panel
- **Page Management**: Full CRUD operations
- **Block Builder**: Visual custom block creation
- **Site Settings**: Comprehensive configuration
- **Theme Management**: Dynamic Tailwind configuration

### Developer Tools

[](#developer-tools)

- **Error Handling**: Robust setup with fallbacks
- **Namespace Management**: Automatic App namespace conversion
- **Asset Management**: CSS, JS, and view publishing
- **Command Line**: Artisan commands for management

---

📚 Documentation
---------------

[](#-documentation)

- **[Setup Guide](LARALGRAPE_SETUP.md)** - Complete installation and configuration
- **[Block System](BLOCKS_README.md)** - Dynamic block loading and management
- **[Component System](COMPONENTS_README.md)** - Modular component architecture
- **[Custom Blocks](CUSTOM_BLOCKS_README.md)** - Visual block builder guide
- **[API Documentation](API_README.md)** - Service classes and methods
- **[Troubleshooting](TROUBLESHOOTING.md)** - Common issues and solutions

---

🎨 Customization
---------------

[](#-customization)

### Adding Custom Blocks

[](#adding-custom-blocks)

1. Use the visual block builder in the admin panel
2. Or create `.blade.php` files in `resources/views/filament/blocks/`
3. Add metadata comments for automatic loading

### Styling

[](#styling)

- **Global Styles**: Edit `resources/css/site.css`
- **Tailwind Config**: Use the admin panel for dynamic themes
- **Component Styles**: Add custom CSS to blocks

### Extending

[](#extending)

- **New Resources**: Add custom Filament resources
- **Custom Services**: Extend the service classes
- **Frontend**: Modify the layout components

---

🚀 Why Choose LaraGrape?
-----------------------

[](#-why-choose-laragrape)

- **No Code Required**: Visual page building for non-developers
- **Developer Friendly**: Clean, maintainable Laravel code
- **Modern Stack**: Built with Laravel 12+, Filament 5, and Tailwind CSS 4
- **Extensible**: Easy to customize and extend
- **Production Ready**: Robust error handling and fallbacks
- **Active Development**: Regular updates and improvements

---

🤝 Contributing
--------------

[](#-contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

### Development Setup

[](#development-setup)

```
# Clone the repository
git clone https://github.com/your-org/laragrape.git

# Install dependencies
composer install
npm install

# Run tests
php artisan test
```

---

📄 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

---

🆘 Support
---------

[](#-support)

- **Documentation**: Check the docs in this repository
- **Issues**: Report bugs on GitHub
- **Discussions**: Join our community discussions

---

🆕 What's New in V1.2
--------------------

[](#-whats-new-in-v12)

### Major Features

[](#major-features)

- ✅ **Enhanced Setup Command** with robust error handling
- ✅ **Dynamic Tailwind CSS System** with theme management
- ✅ **Advanced Block System** with improved compatibility
- ✅ **Comprehensive Site Settings** with grouped configuration

### Improvements

[](#improvements)

- ✅ **50%+ Performance Improvement**
- ✅ **Complete Documentation** (6 comprehensive guides)
- ✅ **Enhanced Error Handling** throughout the system
- ✅ **Mobile-First Responsive Design**

---

**LaraGrape**: The easiest way to add a modern, visual CMS to your Laravel project—without sacrificing developer control. 🍇

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance95

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 64.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~47 days

Recently: every ~78 days

Total

8

Last Release

36d ago

PHP version history (2 changes)v1.0.0PHP ^8.2

1.4.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/afff2162eb6e5c141b3534b7bb6ca696eb7a3c6df0ec10efe6c75ffcc44b6e81?d=identicon)[Streats22](/maintainers/Streats22)

---

Top Contributors

[![Streats22](https://avatars.githubusercontent.com/u/70856472?v=4)](https://github.com/Streats22 "Streats22 (27 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 commits)")

---

Tags

laravelcmsfilamentgrapesjspage builder

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/streats22-laragrape/health.svg)

```
[![Health](https://phpackages.com/badges/streats22-laragrape/health.svg)](https://phpackages.com/packages/streats22-laragrape)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

211189.7k8](/packages/bezhansalleh-filament-google-analytics)[tapp/filament-form-builder

User facing form builder using Filament components

132.4k3](/packages/tapp-filament-form-builder)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.4k](/packages/tomshaw-electricgrid)[promethys/revive

A 'RecycleBin' page where users can restore or delete permanently soft-deleted models.

162.9k](/packages/promethys-revive)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
