Repository files navigation

This package is for Laravel 6, and isno longer maintained. Please use theLaravel 8 version

Out of the box, Laravel 6 ships with aUI preset forBootstrap andVue.js to make getting your website front-end up and running simple.

Although Bootstrap is very popular, I preferYOOtheme's front-end frameworkUIkit. It's modern, clean, well-thought-out, and modular. I've used it for just about every project I've worked on in the last few years, for both websites and web applications, from tiny single-page landing sites, to massive web applications with thousands of users.

This repository extends Laravel UI with an additional preset for UIkit.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See Deployment for notes on how to deploy the project on a live system.

To begin, you'll need afresh install of Laravel 6.Adding this to an existing project is not recommended and may cause issues. For full instructions on installing Laravel, refer to theLaravel installation docs, but something like the following will get you up and running:

composer global require laravel/installerlaravel new mysitephp artisan serve

Your development site will be served athttp://localhost:8000.

To turn the base Laravel install into a UIkit skeleton site, follow the steps below.

1. Include both Laravel UI and this repository into your composer dependencies:

composer require laravel/uicomposer require torrix/laravel-ui-uikit

2. Run the artisan command to install the preset into your Laravel install. It will overwrite welcome.blade.php, so do not run this on established projects with changes made to that file. You can run the command with or without the--auth flag; this will determine whether or not the login/register routes & views are generated.

php artisan ui uikit --auth

3. Finally, run NPM to download UIkit, and build your assets using Laravel Mix:

npm install && npm run dev

To get started in UIkit, readtheir excellent docs. The examples and tests provided should give you all the help you need. To get an idea of what UIkit is capable of, I highly recommend theKickOff starter templates for inspiration.

To start customising UIkit to your own needs, take a look inapp.scss. In there, you will find the standard UIkit imports, and by way of a simple example, I've changed the default blue primary colour to a nice purple shade, just to show what's possible in almost no time at all. Try changing it to another colour, and then runningnpm run dev to rebuild the CSS, and see the changes to your site.

Whilst developing your site, running Laravel Mix in watch mode makes it easy to make changes and quickly see their results:

npm run watch

When deploying to a live server, remember to build your assets in production mode for smaller, faster downloads:

npm run prod

• Laravel - The awesome PHP framework that makes all of this worthwhile.
• Laravel UI - The default Bootstrap preset Laravel ships with, and this project is based on.
• UIkit - The beautiful, powerful front-end framework that you'll be delighted to build your next Laravel project with!

Please readCONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

We useSemVer for versioning. For the versions available, see thetags on this repository.

• Matt Fletcher -This UIkit preset -Torrix
• Taylor Otwell -The original Bootstrap preset -Laravel UI

This preset is based upon and extends Laravel UI, and is therefore open-source software licensed under theMIT license - see theLICENSE.md file for details