https://github.com/olakunlevpn/mages

A Mages (Bootstrap 5, Alpine.js, Laravel and Livewire) Preset for Laravel
https://github.com/olakunlevpn/mages

Last synced: about 1 month ago
JSON representation

A Mages (Bootstrap 5, Alpine.js, Laravel and Livewire) Preset for Laravel

• Host: GitHub
• URL: https://github.com/olakunlevpn/mages
• Owner: olakunlevpn
• Created: 2023-03-04T16:25:29.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-05-04T11:33:59.000Z (over 1 year ago)
• Last Synced: 2024-10-12T18:41:06.560Z (2 months ago)
• Language: PHP
• Homepage: https://maylancer.org/mages/
• Size: 81.1 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Mages

A Mages (Bootstrap 5, Alpine.js, Laravel and Livewire) Preset for Laravel

[![Latest Stable Version](http://poser.pugx.org/olakunlevpn/mages/v)](https://packagist.org/packages/olakunlevpn/mages) [![Total Downloads](http://poser.pugx.org/olakunlevpn/mages/downloads)](https://packagist.org/packages/olakunlevpn/mages) [![Latest Unstable Version](http://poser.pugx.org/olakunlevpn/mages/v/unstable)](https://packagist.org/packages/olakunlevpn/mages) [![License](http://poser.pugx.org/olakunlevpn/mages/license)](https://packagist.org/packages/olakunlevpn/mages) [![PHP Version Require](http://poser.pugx.org/olakunlevpn/mages/require/php)](https://packagist.org/packages/olakunlevpn/mages)

If you're not familiar with the name, it's an acronym that describes the main technologies involved in the stack:

- [Bootstrap 5](https://getbootstrap.com/)

- [Alpine.js](https://github.com/alpinejs/alpine)

- [Laravel](https://laravel.com)

- [Livewire](https://laravel-livewire.com)

Here are some notable features:

- Views extend a default layout

- Front-end assets like Bootstrap 5 and AlpineJS are set up with Vite

- Bootstrap-powered pagination views

## Installation

This preset is intended to be installed into a fresh Laravel application. Follow [Laravel's installation instructions](https://laravel.com/docs/installation) to ensure you have a working environment before continuing.

![Login View](./Screenshot.png)

### Installation (without auth)

Then simply run the following commands:

```bash

composer require livewire/livewire olakunlevpn/mages

php artisan ui mages

npm install

npm run dev

```

### Installation (with auth)

If you would like to install the preset and its auth scaffolding in a fresh Laravel application, make sure to use the `--auth` flag on the `ui` command:

```bash

composer require livewire/livewire olakunlevpn/mages

php artisan ui mages --auth

npm install

npm run dev

```

Some notable features of the authentication scaffolding include:

- Powered by Livewire components and single action controllers

- Bundled with pre-written tests

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.

## Credits

- [Olakunlevpn](https://github.com/olakunlevpn)

- [All Contributors](../../contributors)