Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bastinald/laravel-livewire-ui
Laravel Livewire UI, Auth, & CRUD starter kit.
https://github.com/bastinald/laravel-livewire-ui
auth bootstrap commands crud generator laravel laravel-livewire livewire package php scaffolding ui
Last synced: 7 days ago
JSON representation
Laravel Livewire UI, Auth, & CRUD starter kit.
- Host: GitHub
- URL: https://github.com/bastinald/laravel-livewire-ui
- Owner: bastinald
- Created: 2021-06-04T23:44:10.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-03-17T20:43:39.000Z (8 months ago)
- Last Synced: 2024-10-14T07:21:51.891Z (25 days ago)
- Topics: auth, bootstrap, commands, crud, generator, laravel, laravel-livewire, livewire, package, php, scaffolding, ui
- Language: PHP
- Homepage:
- Size: 194 KB
- Stars: 101
- Watchers: 5
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Laravel Livewire Ui
This package will create UI & auth scaffolding for your next Laravel project through a single command. It does so using Laravel Livewire & Bootstrap 5. Think of it as a minimal, modernized version of the old Laravel UI package. This is ideal for people who prefer Bootstrap over Tailwind, and don't need all the extra's that come with Jetstream.
## Documentation
- [Requirements](#requirements)
- [Packages Used](#packages-used)
- [Installation](#installation)
- [Commands](#commands)
- [Making UI](#making-ui)
- [Making Auth](#making-auth)
- [Publishing Stubs](#publishing-stubs)
## Requirements
- A server with Laravel 8 support
- NPM installed on the dev machine
## Packages Used
The following packages are used by this package, so you may want to become familiar with them:
- [Laravel Automatic Migrations](https://github.com/bastinald/laravel-automatic-migrations)
- [Laravel Livewire Routes](https://github.com/bastinald/laravel-livewire-routes)
- [Honey](https://github.com/lukeraymonddowning/honey)
## Installation
This package was designed to work with new Laravel projects.
Make a Laravel project via Valet, Docker, or whatever you prefer:
```console
laravel new my-project
```
Configure your `.env` APP, DB, and MAIL values:
```env
APP_*
DB_*
MAIL_*
```
Require the package via composer:
```console
composer require bastinald/laravel-livewire-ui
```
Make UI scaffolding:
```console
php artisan make:ui
```
Or, make UI scaffolding including auth:
```console
php artisan make:ui -a
```
## Commands
### Making UI
Make UI scaffolding including the layouts, assets, NPM config, etc.:
```console
php artisan make:ui {--a|--auth} {--force}
```
Use the `-a` option to make auth at the same time.
### Making Auth
Make auth scaffolding including login, register, password resets, etc.:
```console
php artisan make:auth {--force}
```
Only run this command after making UI if you did not use the `-a` option.
### Clearing the Log
Delete the `laravel.log` file:
```console
php artisan log:clear
```
## Publishing Stubs
Use your own UI & auth stubs by publishing package files:
```console
php artisan vendor:publish --tag=laravel-livewire-ui
```
Update the `stub_path` in `config/laravel-livewire-ui.php`:
```php
'stub_path' => resource_path('stubs/vendor/laravel-livewire-ui'),
```
Now edit the stub files inside `resources/stubs/vendor/laravel-livewire-ui`. The commands will now use these stub files to make UI & auth.