├── .github
└── workflows
│ └── tests.yml
├── .gitignore
├── README.md
├── package.json
├── src
└── preset.js
├── templates
├── auth
│ ├── app
│ │ └── Http
│ │ │ ├── Controllers
│ │ │ ├── Auth
│ │ │ │ ├── EmailVerificationController.php
│ │ │ │ └── LogoutController.php
│ │ │ └── Controller.php
│ │ │ └── Livewire
│ │ │ └── Auth
│ │ │ ├── Login.php
│ │ │ ├── Passwords
│ │ │ ├── Confirm.php
│ │ │ ├── Email.php
│ │ │ └── Reset.php
│ │ │ ├── Register.php
│ │ │ └── Verify.php
│ ├── database
│ │ └── migrations
│ │ │ └── 2014_10_12_100000_create_password_resets_table.php
│ ├── resources
│ │ └── views
│ │ │ ├── layouts
│ │ │ └── auth.blade.php
│ │ │ └── livewire
│ │ │ └── auth
│ │ │ ├── login.blade.php
│ │ │ ├── passwords
│ │ │ ├── confirm.blade.php
│ │ │ ├── email.blade.php
│ │ │ └── reset.blade.php
│ │ │ ├── register.blade.php
│ │ │ └── verify.blade.php
│ ├── routes
│ │ └── web.php
│ └── tests
│ │ └── Feature
│ │ ├── Auth
│ │ ├── LoginTest.php
│ │ ├── LogoutTest.php
│ │ ├── Passwords
│ │ │ ├── ConfirmTest.php
│ │ │ ├── EmailTest.php
│ │ │ └── ResetTest.php
│ │ ├── RegisterTest.php
│ │ └── VerifyTest.php
│ │ └── ExampleTest.php
└── default
│ ├── public
│ └── favicon.ico
│ ├── resources
│ ├── js
│ │ ├── app.js
│ │ └── bootstrap.js
│ └── views
│ │ ├── components
│ │ └── logo.blade.php
│ │ ├── layouts
│ │ ├── app.blade.php
│ │ └── base.blade.php
│ │ ├── vendor
│ │ ├── livewire
│ │ │ └── pagination-links.blade.php
│ │ └── pagination
│ │ │ ├── default.blade.php
│ │ │ └── simple-default.blade.php
│ │ └── welcome.blade.php
│ ├── routes
│ └── web.php
│ └── tests
│ ├── Feature
│ └── ExampleTest.php
│ └── TestCase.php
└── yarn.lock
/.github/workflows/tests.yml:
--------------------------------------------------------------------------------
1 | name: tests
2 |
3 | on:
4 | push:
5 | pull_request:
6 | schedule:
7 | - cron: "0 0 * * *"
8 |
9 | jobs:
10 | run:
11 | name: P${{ matrix.php }} - L${{ matrix.laravel }}
12 | runs-on: ubuntu-latest
13 |
14 | env:
15 | DB_CONNECTION: mysql
16 | DB_DATABASE: laravel
17 | DB_USERNAME: root
18 | DB_PASSWORD: password
19 |
20 | services:
21 | mysql:
22 | image: mysql:5.7
23 | env:
24 | MYSQL_ALLOW_EMPTY_PASSWORD: false
25 | MYSQL_ROOT_PASSWORD: password
26 | MYSQL_DATABASE: laravel
27 | ports:
28 | - 3306/tcp
29 | options: --health-cmd="mysqladmin ping" --health-interval=10s --health-timeout=5s --health-retries=3
30 |
31 | strategy:
32 | fail-fast: false
33 | matrix:
34 | php: [7.4]
35 | laravel: [^8.0]
36 |
37 | steps:
38 | - name: Checkout code
39 | uses: actions/checkout@v2
40 |
41 | - name: Cache dependencies
42 | uses: actions/cache@v1
43 | with:
44 | path: ~/.composer/cache/files
45 | key: dependencies-laravel-${{ matrix.laravel }}-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
46 |
47 | - name: Set up PHP
48 | uses: shivammathur/setup-php@v2
49 | with:
50 | php-version: ${{ matrix.php }}
51 | extensions: dom, curl, libxml, mbstring, zip
52 | coverage: none
53 |
54 | - name: Start mysql service
55 | run: sudo /etc/init.d/mysql start
56 |
57 | - name: Create Laravel app
58 | run: composer create-project laravel/laravel=${{ matrix.laravel }} ../app --prefer-dist
59 |
60 | - name: Install preset
61 | run: |
62 | cd ../app
63 | npx use-preset laravel-tall --auth --debug --no-interaction
64 |
65 | - name: Install dependencies
66 | run: |
67 | cd ../app
68 | composer update
69 |
70 | - name: Execute tests
71 | run: |
72 | cd ../app
73 | vendor/bin/phpunit --verbose
74 | env:
75 | DB_PORT: ${{ job.services.mysql.ports['3306'] }}
76 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | node_modules
2 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 |
Laravel TALL
3 |
4 |
5 | 
6 |
7 |
8 |
9 | 
10 |
11 |
12 |
13 | 
14 |
15 |
16 |
17 | use-preset is a scaffolding tool for developers. Read the documentation for more information.
18 |
19 |
20 |
21 | # About
22 |
23 | > This preset is inspired by [`laravel-frontend-presets/tall`](https://github.com/laravel-frontend-presets/tall/).
24 |
25 | This Laravel preset scaffolds an application using the [`TALL`](https://tallstack.dev/) stack, jumpstarting your application's development. If you are not familiar with the name, it is an acronym that describes the main technologies involved in the stack:
26 |
27 | | [Tailwind CSS](https://tailwindcss.com/) | [Alpine.js](https://github.com/alpinejs/alpine) | [Laravel](https://laravel.com/) | [Livewire](https://laravel-livewire.com/) |
28 | | ---------------------------------------- | ----------------------------------------------- | ------------------------------- | ----------------------------------------- |
29 | | Utility-first CSS framework | Minimal Javascript framework | PHP framework | Full-stack UI Laravel framework |
30 |
31 | # Installation
32 |
33 | This preset is intended to be installed into a fresh Laravel application. Follow the [Laravel installation instructions](https://laravel.com/docs/8.x/installation) to ensure you have a working environment before continuing.
34 |
35 | **Then, run the following command**:
36 |
37 | ```bash
38 | npx apply laravel:tall
39 | ```
40 |
41 | You'll need to run `npm run dev` or `yarn dev` to compile your assets right after.
42 |
43 | Note that because of [an issue with Laravel Mix](https://github.com/JeffreyWay/laravel-mix/pull/2339) itself, the `vue-template-compiler` will be added even though the preset doesn't use Vue. You may need to run `npm install` or `yarn`, then `npm run dev` or `yarn dev` a second time after Mix installs `vue-template-compiler` if it results in an error.
44 |
45 | > An alternative would be to use Webpack Encore instead of Laravel Mix, but no preset exists at this time and Mix will eventually end up fixing that issue (hopefully!).
46 |
47 | ## Authentication
48 |
49 | If you don't want the preset to install the authentication scaffolding, you may use the `--no-auth` flag.
50 |
51 | Some notable features of the authentication scaffolding include:
52 |
53 | - Livewire components ans single action controllers
54 | - Pre-written tests
55 |
56 | All routes, components, controllers and tests are published to your application. The idea behind this is that you have full control over every aspect of the scaffolding in your own app, removing the need to dig around in the vendor folder to figure out how things are working.
57 |
58 | > **Note**: as opposed to other Laravel front-end presets, the authentication logic is published to your application. It means that `laravel/ui` is not required at all.
59 |
60 | ## Pagination
61 |
62 | This preset sets up the paginator in the `AppServiceProvider` file. If you wish to not use it, you can add the `--no-pagination` flag.
63 |
64 | # Credits
65 |
66 | - [Dan Harrin](https://github.com/DanHarrin)
67 | - [Liam Hammett](https://github.com/imliam)
68 | - [Ryan Chandler](https://github.com/ryangjchandler)
69 | - [Enzo Innocenzi](https://github.com/innocenzi)
70 | - [Tailwind UI](https://tailwindui.com/) for the default authentication and pagination views
71 | - [`laravel-frontend-presets/tall`'s contributors](https://github.com/laravel-frontend-presets/tall/contributors)
72 | - [`use-preset`](https://github.com/use-preset/use-preset)
73 |
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "laravel-tall-preset",
3 | "version": "0.1.4",
4 | "license": "MIT",
5 | "preset": "src/preset.js",
6 | "devDependencies": {
7 | "standard-version": "^8.0.2",
8 | "use-preset": "^0.1.15"
9 | },
10 | "scripts": {
11 | "release": "standard-version --skip.changelog"
12 | }
13 | }
14 |
--------------------------------------------------------------------------------
/src/preset.js:
--------------------------------------------------------------------------------
1 | const { Preset } = require('use-preset');
2 |
3 | // prettier-ignore
4 | module.exports = Preset.make('Laravel TALL')
5 | .option('auth', true)
6 | .option('pagination', true)
7 | .option('interaction', true)
8 |
9 | .apply('use-preset/laravel-tailwindcss')
10 | .with('--no-interaction')
11 | .title('Add Tailwind CSS from its preset')
12 | .chain()
13 |
14 | .editJson('package.json')
15 | .title('Add Alpine.js, remove Lodash & Axios')
16 | .merge({
17 | devDependencies: {
18 | alpinejs: '^2',
19 | },
20 | })
21 | .delete(['devDependencies.lodash', 'devDependencies.axios'])
22 | .chain()
23 |
24 | .editJson('composer.json')
25 | .title('Add Livewire')
26 | .merge({
27 | require: {
28 | 'livewire/livewire': '^2.0',
29 | }
30 | })
31 | .chain()
32 |
33 | .copyDirectory('default')
34 | .to('/')
35 | .title('Copy templates')
36 | .whenConflict('override')
37 | .chain()
38 |
39 | .copyDirectory('auth')
40 | .to('/')
41 | .title('Scaffold authentication')
42 | .if(({ flags }) => Boolean(flags.auth))
43 | .whenConflict('override')
44 | .chain()
45 |
46 | .edit(['app/Providers/RouteServiceProvider.php', 'app/Http/Middleware/RedirectIfAuthenticated.php'])
47 | .title('Update route configuration')
48 | .replace(`public const HOME = '/home';`).with(`public const HOME = '/';`)
49 | .replace(`$namespace = 'App\\Http\\Controllers'`).with(`$namespace = ''`)
50 | .chain()
51 |
52 | .edit('app/Providers/AppServiceProvider.php')
53 | .title('Setup pagination')
54 | .if(({ flags }) => Boolean(flags.pagination))
55 | .search(/public function boot\(\)/)
56 | .addAfter([
57 | `{`,
58 | ` Paginator::defaultView('pagination::default');`,
59 | ` Paginator::defaultSimpleView('pagination::simple-default');`,
60 | ])
61 | .removeAfter(2) // Removes opening curly bracket and comment
62 | .end()
63 | .chain()
64 |
65 | .installDependencies()
66 | .if(({ flags }) => Boolean(flags.interaction))
67 | .for('node')
68 | .title('Install node dependencies')
69 | .chain()
70 |
71 | .updateDependencies()
72 | .if(({ flags }) => Boolean(flags.interaction))
73 | .for('php')
74 | .title('Install PHP dependencies')
75 | .chain();
76 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Controllers/Auth/EmailVerificationController.php:
--------------------------------------------------------------------------------
1 | getKey())) {
16 | throw new AuthorizationException();
17 | }
18 |
19 | if (!hash_equals((string) $hash, sha1(Auth::user()->getEmailForVerification()))) {
20 | throw new AuthorizationException();
21 | }
22 |
23 | if (Auth::user()->hasVerifiedEmail()) {
24 | return redirect(route('home'));
25 | }
26 |
27 | if (Auth::user()->markEmailAsVerified()) {
28 | event(new Verified(Auth::user()));
29 | }
30 |
31 | return redirect(route('home'));
32 | }
33 | }
34 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Controllers/Auth/LogoutController.php:
--------------------------------------------------------------------------------
1 | validate([
23 | 'email' => ['required', 'email'],
24 | 'password' => ['required'],
25 | ]);
26 |
27 | if (!Auth::attempt($credentials, $this->remember)) {
28 | $this->addError('email', trans('auth.failed'));
29 |
30 | return;
31 | }
32 |
33 | return redirect()->intended(route('home'));
34 | }
35 |
36 | public function render()
37 | {
38 | return view('livewire.auth.login')->extends('layouts.auth');
39 | }
40 | }
41 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Livewire/Auth/Passwords/Confirm.php:
--------------------------------------------------------------------------------
1 | validate([
15 | 'password' => 'required|password',
16 | ]);
17 |
18 | session()->put('auth.password_confirmed_at', time());
19 |
20 | return redirect()->intended(route('home'));
21 | }
22 |
23 | public function render()
24 | {
25 | return view('livewire.auth.passwords.confirm')->extends('layouts.auth');
26 | }
27 | }
28 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Livewire/Auth/Passwords/Email.php:
--------------------------------------------------------------------------------
1 | validate([
19 | 'email' => ['required', 'email'],
20 | ]);
21 |
22 | $response = $this->broker()->sendResetLink(['email' => $this->email]);
23 |
24 | if ($response == Password::RESET_LINK_SENT) {
25 | $this->emailSentMessage = trans($response);
26 |
27 | return;
28 | }
29 |
30 | $this->addError('email', trans($response));
31 | }
32 |
33 | /**
34 | * Get the broker to be used during password reset.
35 | *
36 | * @return \Illuminate\Contracts\Auth\PasswordBroker
37 | */
38 | public function broker()
39 | {
40 | return Password::broker();
41 | }
42 |
43 | public function render()
44 | {
45 | return view('livewire.auth.passwords.email')->extends('layouts.auth');
46 | }
47 | }
48 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Livewire/Auth/Passwords/Reset.php:
--------------------------------------------------------------------------------
1 | token = $token;
30 | }
31 |
32 | public function resetPassword()
33 | {
34 | $this->validate([
35 | 'token' => 'required',
36 | 'email' => 'required|email',
37 | 'password' => 'required|min:8|same:passwordConfirmation',
38 | ]);
39 |
40 | $response = $this->broker()->reset(
41 | [
42 | 'token' => $this->token,
43 | 'email' => $this->email,
44 | 'password' => $this->password
45 | ],
46 | function ($user, $password) {
47 | $user->password = Hash::make($password);
48 |
49 | $user->setRememberToken(Str::random(60));
50 |
51 | $user->save();
52 |
53 | event(new PasswordReset($user));
54 |
55 | $this->guard()->login($user);
56 | }
57 | );
58 |
59 | if ($response == Password::PASSWORD_RESET) {
60 | session()->flash(trans($response));
61 |
62 | return redirect(route('home'));
63 | }
64 |
65 | $this->addError('email', trans($response));
66 | }
67 |
68 | /**
69 | * Get the broker to be used during password reset.
70 | *
71 | * @return \Illuminate\Contracts\Auth\PasswordBroker
72 | */
73 | public function broker()
74 | {
75 | return Password::broker();
76 | }
77 |
78 | /**
79 | * Get the guard to be used during password reset.
80 | *
81 | * @return \Illuminate\Contracts\Auth\StatefulGuard
82 | */
83 | protected function guard()
84 | {
85 | return Auth::guard();
86 | }
87 |
88 | public function render()
89 | {
90 | return view('livewire.auth.passwords.reset')->extends('layouts.auth');
91 | }
92 | }
93 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Livewire/Auth/Register.php:
--------------------------------------------------------------------------------
1 | validate([
28 | 'name' => ['required'],
29 | 'email' => ['required', 'email', 'unique:users'],
30 | 'password' => ['required', 'min:8', 'same:passwordConfirmation'],
31 | ]);
32 |
33 | $user = User::create([
34 | 'email' => $this->email,
35 | 'name' => $this->name,
36 | 'password' => Hash::make($this->password),
37 | ]);
38 |
39 | event(new Registered($user));
40 |
41 | Auth::login($user, true);
42 |
43 | return redirect()->intended(route('home'));
44 | }
45 |
46 | public function render()
47 | {
48 | return view('livewire.auth.register')->extends('layouts.auth');
49 | }
50 | }
51 |
--------------------------------------------------------------------------------
/templates/auth/app/Http/Livewire/Auth/Verify.php:
--------------------------------------------------------------------------------
1 | hasVerifiedEmail()) {
14 | redirect(route('home'));
15 | }
16 |
17 | Auth::user()->sendEmailVerificationNotification();
18 |
19 | $this->emit('resent');
20 |
21 | session()->flash('resent');
22 | }
23 |
24 | public function render()
25 | {
26 | return view('livewire.auth.verify')->extends('layouts.auth');
27 | }
28 | }
29 |
--------------------------------------------------------------------------------
/templates/auth/database/migrations/2014_10_12_100000_create_password_resets_table.php:
--------------------------------------------------------------------------------
1 | string('email')->index();
18 | $table->string('token');
19 | $table->timestamp('created_at')->nullable();
20 | });
21 | }
22 |
23 | /**
24 | * Reverse the migrations.
25 | *
26 | * @return void
27 | */
28 | public function down()
29 | {
30 | Schema::dropIfExists('password_resets');
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/templates/auth/resources/views/layouts/auth.blade.php:
--------------------------------------------------------------------------------
1 | @extends('layouts.base')
2 |
3 | @section('body')
4 |
5 | @yield('content')
6 |
7 | @isset($slot)
8 | {{ $slot }}
9 | @endisset
10 |
11 | @endsection
12 |
--------------------------------------------------------------------------------
/templates/auth/resources/views/livewire/auth/login.blade.php:
--------------------------------------------------------------------------------
1 | @section('title', 'Sign in to your account')
2 |
3 |
77 |
--------------------------------------------------------------------------------
/templates/auth/resources/views/livewire/auth/passwords/confirm.blade.php:
--------------------------------------------------------------------------------
1 | @section('title', 'Confirm your password')
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
12 |
13 | Please confirm your password before continuing
14 |
15 |
16 |
17 |
52 |
4 |
13 |
14 |
15 |
16 | @if ($emailSentMessage)
17 |
18 |
19 |
24 |
25 |
26 |
27 | {{ $emailSentMessage }}
28 |
29 |
30 |
31 |
32 | @else
33 |
56 | @endif
57 |
58 |
59 |
4 |
24 |
25 |
26 |
27 | @if (session('resent'))
28 |
29 |
32 |
33 |
A fresh verification link has been sent to your email address.
34 |
35 | @endif
36 |
37 |
38 |
Before proceeding, please check your email for a verification link.
39 |
40 |
41 | If you did not receive the email, click here to request another.
42 |
43 |
44 |
45 |
46 |
5 |
6 | @if (Route::has('login'))
7 |
28 | @endif
29 |
30 |
31 |
59 |