https://github.com/stats4sd/laravel-10-template
A template for using Laravel 10 and Backpack 6
https://github.com/stats4sd/laravel-10-template
Last synced: 15 days ago
JSON representation
A template for using Laravel 10 and Backpack 6
- Host: GitHub
- URL: https://github.com/stats4sd/laravel-10-template
- Owner: stats4sd
- Created: 2023-08-17T11:39:35.000Z (almost 3 years ago)
- Default Branch: dev
- Last Pushed: 2023-09-01T11:22:14.000Z (almost 3 years ago)
- Last Synced: 2025-02-23T13:15:34.591Z (over 1 year ago)
- Language: PHP
- Size: 146 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
r# Laravel Template
This repo is a template for new projects using:
- Laravel 10
- Backpack 6
- Backpack Pro (the requirement is there in the composer.json file. Remove it if you don't have the licence or don't want to use closed-source packages)
## Setup Process
To start using this template for a new application:
1. Create a new repository, using this as a template.
2. Do the normal Laravel setup stuff:
- copy the .env.example file to .env and update the contents to match your local environment
- run `composer install`
- run `npm install`
- run `php artisan migrate:fresh --seed`
- run `php artisan key:generate`
## How is this template different from a clean installation?
The template is intended as a quick-start to Stats4SD projects, and is opinionated in a few ways:
### Authentication
This template was setup using Laravel Breeze for the authentication. The Backpack auth routes have not been enabled, and instead Backpack redirects / defers to the routes setup in the `routes/auth.php` file.
**Changes**:
- The Logout button in the Backpack menu has been changed from an tag to a form, because the default logout route from Breeze requires a POST request.
- This change is in Theme Tabler. If you change backpack themes, you will need to make this change again in your chosen theme.
- The app redirects from `/` to `/admin` by default, assuming that you want to use Backpack as the main UI. This can be changed if you need a separate front-end.
### Frontend Assets
Vite is set up as the default compiler. There are 2 sets of javascript and scss files.
- `backpack.js` + `backpack.scss`, which get included in all backpack-rendered pages, to allow quick modifications to the theme or the addition of custom JS to the whole admin panel.
- `app.js` + `app.scss`, which are included in the `views/layouts` blade templates for use in a separate front-end if required.
### Front-end frameworks
- Backpack's Theme Tabler uses Bootstrap 5, so the easiest approach to styling the admin panel is to write Bootstrap-compatible css.
- The front-end pages, including the Authentication views (login, password reset etc) use Tailwind. If needed, you can change this to Bootstrap by modifying the `views/layouts/` and `views/auth` blade templates.
### VueJS
There is a `vuedefault.js` file that includes the boilerplate for adding VueJS components to pages. We often have a few pages that include a VueJS component, so you could create one vue setup file for each page that uses it, and only register the components required for that page. That way, Vue is not loaded when it is not needed. Alternatively, if Vue is used everywhere, one single setup file that registers *all* the components will be fine.