README.md

default-laravel

Start your next laravel project faster.

This is clean Laravel install with added tools and changes to get your next project started faster. It includes useful tools for increasing efficiency, TailwindCSS, webpack set up for Tailwind and BrowserSync, and some basic blade template changes.

What this repo contains

Dependencies

These are the dependencies this repo pulls in:

$ composer require barryvdh/laravel-debugbar --dev

$ composer require sven/artisan-view --dev

$ composer require --dev ajthinking/tinx

$ composer require --dev pipe-dream/laravel

$ composer require spatie/laravel-permission

And it also has TailwindCSS:

$ npm install tailwindcss

Modifications

These are the actions that have already been taken:

Spatie migrations published:

$ php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider" --tag="migrations"

The tailwind.config.js file created:

$ npx tailwind init

Laravel Auth routes set up:

$ php artisan make:auth

The register route has been taken away. Delete the square brackets and their contents if you want it back:

//web.php

Auth::routes(['register' => false]);

webpack.mix.js is edited for TailwindCSS and BrowserSync:

//webpack.mix.js
const mix = require('laravel-mix');

const tailwindcss = require('tailwindcss');

mix.js('resources/js/app.js', 'public/js');

mix.sass('resources/sass/app.scss', 'public/css')
    .options({
        processCssUrls: false,
        postCss: [ tailwindcss('./tailwind.config.js') ],
    });

mix.browserSync({
    proxy: 'default-laravel.test'
});

head.blade.php and nav.blade.php have split out the relevant parts from the default Laravel files.

alerts.blade.php has been added for simple flash alert usage, eg:

return route('name')->with('success', 'You succeeed!');

And a blank footer.blade.php has been added, because.

Installation and set up

Installation

Download it to your local computer with:

$ git clone https://github.com/forrestedw/default-laravel.git

cd into the repo:

$ cd default-laravel

Install all dependencies from composer.json:

$ composer update

Install all dependencies from package.json:

$ npm install

Set up

Make your .env :

$ cp .env.example .env

Generate an application key:

$ php artisan key:generate

Link the storage files:

$ php artisan storage:link

Go make something great!

Note: Although TailwindCSS is added as a package, you need to uncomment it in resources/sass/app.scss and comment out the other default Laravel lines. This is because none of the class names have been changed, so they are all still the default Laravel Bootstrap class names. That is left to you.