Download the PHP package ginkelsoft/buildora without Composer

Buildora

Buildora is a Laravel package for building admin panels, resources, forms, datatables, widgets and actions — fully based on Eloquent models and a minimal amount of configuration.

1. Requirements

• Laravel 10, 11 or 12
• PHP 8.1+
• Tailwind CSS (via CDN or Vite)
• Laravel Jetstream (optional)
• spatie/laravel-permission (recommended)

2. Installation via Composer

If you are using a local path-based package:

Then:

3. Publish the config (optional)

If Buildora provides configuration, you can publish it with:

4. Run the interactive installer

This command will:

• Detect Laravel version
• Run migrations
• Add necessary traits to your User model
• Generate Buildora resources for all your models
• Generate permissions (if Spatie is installed)
• Create a default admin user

5. Command: buildora:resource

Generate a Buildora resource class based on an Eloquent model:

This will create a file like: app/Buildora/Resources/UserBuildora.php

You can customize fields, filters, actions, and views inside this class.

6. Command: buildora:widget

Create a dashboard widget:

This will generate:

• app/Buildora/Widgets/StatsWidget.php

Each widget implements a render() method and can return a Blade view or raw HTML.

7. Field types

Buildora supports multiple field types. Each field can be configured using a fluent API:

Examples:

You can add new field types by extending the Field base class and implementing the render() method.

8. Widgets

Widgets can be used on dashboards or as panels on detail pages.

Widgets are registered in your resource via:

9. Panels

Panels are relation-based data sections shown on the detail page of a resource.

This will show a datatable of related data on the detail page. Buildora automatically eager-loads these relations to prevent N+1 query issues.

10. Actions

Actions allow you to perform operations on individual records (RowAction) or multiple selected records (BulkAction).

Row Actions

Row actions appear on individual rows in datatables and detail pages:

Bulk Actions

Bulk actions allow operations on multiple selected records:

11. Permissions

Buildora integrates with Spatie Laravel Permission for authorization. Permissions are automatically generated per resource.

Available Commands

Permission Format

Permissions follow the format {resource}.{action}:

• user.view - View user listings
• user.create - Create new users
• user.edit - Edit existing users
• user.delete - Delete users

Checking Permissions in Resources

You can control access to actions using permissions:

12. Global Search

Configure global search behavior per resource:

The label can be:

• A string (column name)
• An array of column names
• A callable that receives the record and returns a string

13. Configuration

The main configuration file config/buildora.php contains:

Route Settings

Models Namespace

Datatable Defaults

File Upload Settings

Dashboard Configuration

Navigation Structure

Navigation items support:

• route + params: Link to a named Laravel route
• url: Direct URL (internal or external)
• children: Nested dropdown menu

14. All Available Commands

15. Theme Customization

Buildora uses CSS variables for theming with support for light and dark mode.

Publishing the Theme

This will create resources/buildora/buildora-theme.css in your Laravel application.

Customizing Colors

Edit the published theme file to override CSS variables:

The theme system uses RGB values to allow alpha transparency (e.g., rgba(var(--primary-rgb), 0.5)).

Frontend Build

If you're developing the package itself, you can rebuild the assets:

16. License

Buildora is open-source software licensed under the MIT license.