README

Laravue

Laravue (pronounced /ˈlarəvjuː/) 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.

Documentation: https://doc.laravue.dev

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

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, please look at the release tags on this repository.

Authors

• Tuan Duong - Initial work - tuandm.
• Tony Tin Nguyen - Frontend and Designer - nguyenquangtin.

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.

Related projects

• Laravue-core - Laravel package which provides core functionalities of Laravue.

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.

Donate

If you find this project useful, you can buy me a coffee