Download the PHP package monstrex/ave without Composer

Ave Admin Panel

A modern, declarative admin panel for Laravel with advanced media management and composable field architecture.

Key Features

• Advanced Media System - State-path based collections, deferred actions, multiple upload strategies, image conversions, drag-n-drop reordering
• Fieldset Component - Repeatable field groups stored in JSON with nested media support, drag-n-drop sorting, and automatic cleanup
• Hierarchical Relations - BelongsToSelect with automatic parent-child tree building and visual indentation
• Modal CRUD - Create and edit records in modals without page reload
• Inline Editing - Edit table cells directly with text, number, and toggle support
• Rich Components - 23 field types including RichEditor (Jodit), CodeEditor, hierarchical selects
• Granular ACL - Role-based permissions with groups, bulk operations, caching, and default roles

Requirements

• PHP 8.2 or higher
• Laravel 12.0 or higher

Installation

Install via Composer and run the setup command:

This will:

• Publish configuration and assets
• Run migrations
• Set up the admin panel at /admin

Options:

Uninstallation

To completely remove Ave Admin Panel from your application:

This will:

• Drop all Ave database tables
• Delete published config and assets
• Remove admin users (optional)
• Clear Ave cache entries

Options:

Note: After uninstalling, remove the package from composer:

Quick Start

Create a resource in app/Ave/Resources:

Visit /admin/posts to see your resource.

Components

Fields (23 types)

Text Inputs:

• TextInput - Single-line with type variants (email, url, tel, number), prefix/suffix, validation
• Textarea - Multi-line text
• Number - Numeric input with min/max/step
• PasswordInput - Password field
• Hidden - Hidden field

Rich Editors:

• RichEditor - WYSIWYG editor powered by Jodit with toolbar presets (minimal/basic/full), feature toggles, and customizable height
• CodeEditor - Syntax-highlighted code editing with modes (html, css, js, php, json, xml, sql, markdown, yaml) and themes (monokai, github, twilight)

Selects:

• Select - Dropdown with options array
• BelongsToSelect - Relation selector with hierarchical support (automatic parent-child tree building), query modifiers, nullable
• BelongsToManySelect - Multiple selection for many-to-many relations with automatic pivot sync
• CheckboxGroup - Group of checkboxes
• RadioGroup - Radio button group

Toggles:

• Checkbox - Single checkbox
• Toggle - Switch toggle

Specialized:

• DateTimePicker - Date and time selection
• ColorPicker - Color picker
• Tags - Tag input
• Slug - Auto-generate slug from another field

Files & Media:

• File - Document uploads with MIME type filtering, filename strategies (original, transliterate, unique), path strategies (flat, dated, custom)
• Media - Advanced media library with:
  • Single/multiple files (with maxFiles limit)
  • Drag & drop upload and reordering
  • Image conversions (thumbnail, medium, large)
  • Metadata (title, alt, caption, position, custom props)
  • Collections for grouping
  • Preset system: SingleImagePreset, GalleryPreset, DocumentsPreset, IconsPreset
  • State-path based collection naming for nested fields
  • Deferred actions for newly created models
  • Automatic cleanup when deleting Fieldset items

Containers:

• Fieldset - Repeatable field groups stored in JSON with:
  • Add/remove/reorder items (drag & drop)
  • Collapsible/collapsed state
  • Stable IDs for media fields
  • Support for nested Media with deterministic collection names
  • minItems/maxItems limits
  • Custom add/delete button labels
  • Head title/preview from field values
  • Automatic media cleanup on item deletion

Layout:

• Row - Bootstrap grid row
• Col - Bootstrap grid column (1-12)
• Panel - Panel with header
• Tabs / Tab - Tabbed interface
• Div - Container with conditional visibility
• Group - Element grouping

Columns (7 types)

• Column - Universal column with sorting, searching, formatting, alignment, width control, text wrapping, inline editing, styling (fontSize, bold, italic, color), and links (linkToEdit, linkUrl, linkAction)
• TextColumn - Text display (extends Column)
• BooleanColumn - Boolean indicator with custom labels, icons, colors, and inline toggle editing
• ImageColumn - Image display with sizes, shapes (square, circle), lightbox, single/multiple modes, stack/grid layouts, and media library integration with conversion support
• BadgeColumn - Badge/tag display
• ComputedColumn - Calculated values
• TemplateColumn - Custom Blade template

Actions (8 types)

Row Actions:

• EditAction - Navigate to edit page
• EditInModalAction - Edit in modal without page reload
• DeleteAction - Delete with confirmation
• RestoreAction - Restore soft-deleted records

Global Actions:

• CreateInModalAction - Create in modal without page reload

Form Actions:

• SaveFormAction - Save and return
• SaveAndContinueFormAction - Save and continue editing
• CancelFormAction - Cancel and return

Advanced Features

Media System

The Media field provides enterprise-level file management:

How it works:

• Files are stored in ave_media table with metadata
• State-path determines collection name (e.g., gallery → collection)
• Supports nested fields through meta keys
• Deferred actions handle new model creation
• Automatic cleanup when parent is deleted

Fieldset with Nested Media

Create repeatable structures with media support:

Features:

• Stable item IDs for media correlation
• Drag & drop reordering
• Automatic media cleanup on item deletion
• Nested media uses deterministic collection names
• Template fields for dynamic addition

Hierarchical Relations

Build tree structures in dropdowns:

Displays as:

Inline Editing

Edit table cells directly:

Access Control

Define granular permissions:

Check permissions:

Features:

• Role-based with groups for organization
• Super role bypasses all checks
• Default roles for new users
• Bulk permission checks (optimized)
• Caching with configurable TTL

Lifecycle Hooks

Intercept CRUD operations:

Available hooks: beforeCreate, afterCreate, beforeUpdate, afterUpdate, afterDelete

Configuration

Customize in config/ave.php:

Customization

Publish assets for customization:

Development

Run tests:

Build assets:

License

MIT License. See LICENSE for details.

Credits

Developed by Monstrex.

Support

Report issues at GitHub issue tracker.