search

tuandm / laravue-core

Laravel package to provide core functionalities of Laravue dashboard
https://laravue.dev
MIT License
150 stars 50 forks source link
laravel php vue vuejs

readme

Laravue Core

The Laravel package to provide core functionalities for a beautiful Laravel dashboard

Demo: https://core.laravue.dev

Getting Started

Laravue provides necessary Element UI and rich features for an enterprise admin dashboard, therefore it's highly recommended to use for starting a project. The following instructions are for intergrating core features of Laravue to existing Laravel project or to experiement with it.

Prerequisites

Laravue is built on top of Laravel and so you have to check Laravel's system requirement and make sure your your NodeJS is ready before starting.

Installing

Install laravue-core package with composer

composer require tuandm/laravue-core

1.a Setup Laravue with all-in-one command

php artisan laravue:setup

This command will do these steps:

Laravue setup

1.b Manual setup

It's recommended to use laravue:setup command. If you want to manually install, you can do following setps:

.env file

Generate JWT secret for authentication

php artisan jwt:secret

Add these two lines to .env file

  BASE_API=/api
  MIX_BASE_API="${BASE_API}"
Publish vendor packages/assets
php artisan vendor:publish --provider="Tuandm\Laravue\ServiceProvider" --tag="laravue-core"
php artisan vendor:publish --provider="Tuandm\Laravue\ServiceProvider" --tag="laravue-asset"
Add NPM dependencies
npm add babel-plugin-syntax-dynamic-import babel-plugin-syntax-jsx babel-plugin-transform-vue-jsx eslint eslint-loader eslint-plugin-vue laravel-mix-eslint vue-template-compiler svg-sprite-loader --save-dev

npm add element-ui js-cookie normalize.css nprogress vuex vue-count-to vue-i18n vue-router 

npm install # To make sure everything is set

Please check package.json sample

Webpack.mix.js configuration

We need to modify the webpack.mix.js to work with Laravue package, please refer to webpack.mix.js sample

Or simply run this command to generate recommendation version.

php artisan laravue:webpack
Babel

Laravue requires babel to build the packages. Usually, .babelrc will be generated with laravue:setup command. Please manual add required plugins to .babelrc file if your project already uses it. Sample .babelrc can be found here

2. Config API guard

Open config/auth.php and modify as below

    # Change default auth guard to api
    'defaults' => [
        'guard' => 'api',
    ],
    ...
    # Use JWT driver for api guard
    'guards' => [
    ....
    'api' => [
        'driver' => 'jwt',
    ....

    # Use Laravue User model to authenticate
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => Tuandm\Laravue\User::class,
        ],

Please refer to auth.php sample

3. Database

Laravue core requires users.role field, consider to run migration if neccessary

php artisan migrate

4. Sample data

This database seeder will insert 3 test users, you can ignore this step if you have data already.

php artisan db:seed --class=Tuandm\\Laravue\\Database\\Seeds\\DatabaseSeeder

Start development

npm run dev # or npm run watch

Build production

npm run production

Running the tests

Built with

Contributing

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

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgements