Skip to content
Laravel preset with inertiaJS, Tailwind CSS and admin theme.
Branch: master
Clone or download
Latest commit f4f0b0f Jul 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Added video to readme Jul 12, 2019
src
.gitignore Added basic structure May 30, 2019
composer.json Add console-task package May 30, 2019
composer.lock
readme.md Added video to readme Jul 12, 2019

readme.md

Harmonic Laravel Preset

Latest Version on Packagist Total Downloads

A Laravel preset that can create a basic Laravel install with some additional composer packages, Cypress for front end testing and an optional starting admin theme using InertiaJS and Tailwind CSS as a quick start.

Laravel Preset - Click for video

Installation

Before you start make sure you have:

  1. A new Laravel installation (this preset will overwrite laravel settings so do not use on existing projects)
  2. yarn installed globally
  3. DB configured in your .env

Then install the preset with composer.

$ composer require harmonic/laravel-preset --dev

Usage

$ php artisan preset harmonic

Once installed you will be prompted to complete installation.

Creating admin pages from models

You can easily and quickly create administration tables with the Harmonic Inertia Table package that is installed as part of the theme. Simply create a migration then run the artisan command:

php artisan make:inertiaTable ModelName

Where ModelName is the name of the model to create an inertia table from, or the name of the model to create based on the name of an existing table. For further details read the docs for the Harmonic Inertia Table package.

Updating the Main Menu

You can manually add items to the left hand side menu by editing js/Shared/MainMenu.vue

Customisation

Once installed you are free to modify all /resources as you see fit. You can easily customise the colour scheme of the theme by editing tailwind.config.js in the project root with the Tailwind colours of your choice:

module.exports = {
	theme: {
		extend: {
			colors: {
				primary: colors.indigo,
				secondary: colors.orange,
				// ...
			  }
		}
	}
  }

What's included?

Composer Packages

Frontend

Stubs

  • .gitignore (to include compiled assets)
  • Removes sass, bootstrap and jquery
  • Inertia JS configuration (installed with theme)
  • Tailwind config (installed with theme)
  • Cypress config (placing cypress inside /tests folder)
  • Authentication stubs (installed with theme)
  • Tailwind admin theme based on Ping CRM interface

Credits

License

Copyright Harmonic New Media

You can’t perform that action at this time.