/Laravel-Vue-Admin

beautiful dashboard combination of Laravel, Vue.js and the UI Toolkit Element.

Primary LanguageVue

vue vue element-ui license

This Application is a beautiful dashboard combination of Laravel, Vue.js and the UI Toolkit Element. The work is inspired by vue-element-admin with our love on top of that. With the powerful Laravel framework as the backend, Vue.js as the high performance on the frontend, Laravue appears to be a full-stack solution for an enterprise application level.

Screenshot

Getting started

Prerequisites

  • Laravue is positioned as an enterprise management solution, and it is highly recommended to use it to start from scratch.
  • For existing Laravel project, you should check Laravue Core for integration.
  • Your machine needs to be ready for the latest Laravel and Node.js.

Installing

Manual

# Clone the project and run composer
composer create-project tuandm/laravue
cd laravue

# Migration and DB seeder (after changing your DB settings in .env)
php artisan migrate --seed

# Install dependency with NPM
npm install

# develop
npm run dev # or npm run watch

# Build on production
npm run production

Docker

docker-compose up -d

Build static files within Laravel container with npm

# Get laravel docker container ID from containers list
docker ps

docker exec -it <container ID> npm run dev # or npm run watch
# Where <container ID> is the "laravel" container name, ex: src_laravel_1

Open http://localhost:8000 (laravel container port declared in docker-compose.yml) to access Laravue

Running the tests

  • Tests system is under development

Deployment and/or CI/CD

This project uses Envoy for deployment, and GitLab CI/CD. Please check Envoy.blade.php and .gitlab-ci.yml for more detail.

Built with

  • Laravel - The PHP Framework For Web Artisans
  • Laravel Sanctum - Laravel Sanctum provides a featherweight authentication system for SPAs and simple APIs.
  • spatie/laravel-permission - Associate users with permissions and roles.
  • 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

Versioning

We use SemVer for versioning. For the versions available, please look at the release tags on this repository.

Acknowledgements

  • 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.