README

Quickly build an admin interface for your Eloquent models. Then customize every little detail. Among its features:

List operation
- 24+ column types
- 1-1, 1-n and n-n relationships
- table view with search, pagination
- click column header to sort by it
- custom buttons
- details row
- bulk actions
- easily create new column types
- easily overwrite an existing column type
Create / Update operations
- 50+ field types
- back-end validation using Laravel Form Requests
- translatable models (multi-language)
- have multiple fields per line
- split fields into tabs
Delete / Bulk Delete operations
Clone / Bulk Clone operations
Reorder operation
Revisions operation (audit log)

But professionals don't love Backpack just because it's feature-packed. They also love it because it's ridiculously easy to overwrite a functionality. Generally, you just need to create a function with the right name or create a blade file with the right name. Yes, it can be that easy. See why thousands of Laravel professionals have been using Backpack, every day, since 2016.

Screenshots

The GIF above should give you with a good idea about what Backpack will help you build. But you can also see it in action in our live demo, to get a deeper understanding of how Backpack admin panels look & feel and the amount of features it provides.

Getting started

Start with the "Getting Started" series in our docs. We try to nudge you towards creating a Backpack acccount, but you don't need one, if you're just trying it out.

Alternatively, if you don't have 20 minutes right now, subscribe to our drip email tutorial. You'll receive one email per day, for 5 days, 5 minutes each. By the end, you'll be familiar with how Backpack works, and be able to create admin panels for your Laravel apps.

Security updates and breaking changes

If you're using Backpack in production, please subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We never ever share your email with anyone & we try to send as few emails as possible (1-4 emails per year). We hate unsolicited email too. But... you know... you're building an admin panel, security should be something you're up-to-date with.

Install

Requirements

If you can run Laravel 8, you can install Backpack. Backpack does not have additional requirements. For the following process, we assume:

you have a working installation of Laravel (an existing project is fine, you don't need a fresh Laravel install);
you have configured your .ENV file with your database and mail information;
you can run the composer command from any directory (you have composer registered as a global command); if you need to run php composer.phar or reference another directory, please remember to adapt the commands below to your configuration;

Installation

Install Core Packages

Open your project folder in your terminal:

cd your-laravel-project-name

In your project's main directory:

# require Backpack using Composer
composer require vuthaihoc/crud:"4.2.*"
composer require --dev backpack/generators:"3.1.11"

# run the installation command
php artisan backpack:install

Backpack install is interactive and will ask questions during instalation, if you don't want that add the --no-interaction argument to the install command.

Change Log

For the current release (4.1.x) please see the Releases tab. For previous versions (Backpack <=4.0.x), please see our old CHANGELOG file.

Contributing Guidelines

This project stands by The Whole Fruit Manifesto. We believe that “writing good code” is not only about “writing good code”. It’s also about the words around it. That’s why, to make sure your contribution is well received, we ask you to read and keep in mind the ONE=MOR framework and guidelines when writing comment blocks, PR titles, PR descriptions, and in general, when writing to our community.

For tasks & details about how you can help our project, please see CONTRIBUTING.

Security

If you discover any security related issues, please email hello@backpackforlaravel.com instead of using the issue tracker. Alternatively, please disclose the issue on huntr.dev to also get a small bounty ($25-40).

It's heavily recommended that you subscribe to the Backpack Newsletter so you can find out about any security updates, breaking changes or major features. We send an email about 3-4 emails per year. Sometimes less.

Credits

Cristian Tabacitu - creator & lead maintainer;
Pedro Martins - maintainer;
António Almeida - maintainer;
All Contributors

Special thanks go to:

Owen Melbourne, Oliver Ziegler, Thomas Swonke, Catalin Tudorache, Abby Janke, David Lloyd - A LOT of new features, bug fixing, support, feedback and code review;
Łukasz Holeczek - creator of CoreUI (used in Backpack v4);
Abdullah Almsaeed - creator of AdminLTE (used in Backpack v3);
John Skoumbourdis - Grocery CRUD for CodeIgniter was a big inspiration for Backpack v1 & v2;
Taylor Otwell & Laravel contributors (of course);

License

Backpack is dual-license:

FREE for non-commercial use
PAID for commercial use

Please see the License File and Pricing for more information.

Versioning

When installing Backpack, require its minor version (currently 4.1.*). For us, this is what major.minor.patch means:

major - PAID upgrade; MAJOR breaking changes; historically every 2-3 years; upgrading may take even 2-3 hours; includes major new features, major changes in how the whole system works, and complete rewrites; it allows us to considerably improve the product, and add features that were previously impossible;
minor - FREE upgrade; MINOR breaking changes; historically every 6-12 months; upgrading takes less than 30 minutes; it allows us to add big new features, for free;
patch - FREE upgrade; NO breaking changes; historically every week; upgrading can be done automatically with composer; includes bug fixes and non-breaking new features;

Hire us

We've spend more than 10.000 hours creating, polishing and maintaining administration panels on Laravel. We've developed e-Commerce, e-Learning, ERPs, social networks, payment gateways and much more. We've worked on admin panels so much, that we've created one of the most popular packages for Laravel - just from making public what was repetitive in our projects.

If you are looking for a developer/team to help you build an admin panel on Laravel, look no further. You'll have a difficult time finding someone with more experience & enthusiasm for admin panels. This is what we do. Contact us.

vuthaihoc / crud

Maintainers

Details