Skip to content
Laravel package to provide core functionalities of Laravue dashboard
Vue JavaScript CSS PHP HTML
Branch: master
Clone or download
tuandm Merge pull request #13 from tuandm/dependabot/npm_and_yarn/eslint-uti…
…ls-1.4.2

Bump eslint-utils from 1.3.1 to 1.4.2
Latest commit dacc118 Oct 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Modify column name "email to role" Mar 19, 2019
.babelrc Init repository and core Mar 17, 2019
.babelrc.sample Init repository and core Mar 17, 2019
.gitignore Init repository and core Mar 17, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Mar 19, 2019
CONTRIBUTING.md Update CONTRIBUTING.md Mar 19, 2019
LICENSE Add MIT License Mar 19, 2019
README.md Update README.md May 28, 2019
composer.json Init repository and core Mar 17, 2019
mix-manifest.json Init repository and core Mar 17, 2019
package-lock.json Merge pull request #13 from tuandm/dependabot/npm_and_yarn/eslint-uti… Oct 15, 2019
package.json Bump lodash from 4.17.11 to 4.17.13 Oct 15, 2019
package.json.sample Update package.json.sample Oct 15, 2019
webpack.mix.js
webpack.mix.js.sample Init repository and core Mar 17, 2019

README.md

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:

  • Setup JWT secret and API endpoint
  • Publish Laravue vendor packages/assets
  • Install NPM dependencies
  • Create .babelc file (if it doesn't exist)
  • Setup webpack.mix.js (please backup this file to make sure the current setting will not be lost)

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

  • Tests system is under development.

Built with

  • Laravel - The PHP Framework For Web Artisans
  • VueJS - The Progressive JavaScript Framework
  • Element - A Vue 2.0 based component library for developers, designers and product managers
  • Vue Admin Template - A minimal vue admin template with Element UI

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

  • Tuan Duong - Initial work - tuandm

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

  • Laravue - A beautiful dashboard for Laravel built by VueJS and ElementUI
  • vue-element-admin A magical vue admin which insprited Laravue project
  • tui.editor - Markdown WYSIWYG Editor
  • Echarts - A powerful, interactive charting and visualization library for browser
You can’t perform that action at this time.