ductranvp / larajs

🌏 LaraJS

LaraJS is a beautiful dashboard combination of Laravel, Vue.js and the UI Toolkit Element. Especially with the code generator function(CREATE, EDIT, DELETE, API, CMS, DATABASE,...) with 100% api and a few other functions and can save about 50% time for the whole project

💌 Demo

https://youtu.be/toI59rLyw_8

☘️ Preparation

** Node

** Git

** Laravel

** Composer

The project is built on top of Laravel, vue, vuex, vue-router, axios and element-ui. Since this is positioned as an enterprise management solution, it is recommended to use it to start a project.

🅰 API

API will be served by Laravel. In this project, you need to run migration and data feeder to generate sample data for authentication/authorization, other APIs will be faked.

✅ Getting started

This project is built on top of fresh latest version Laravel 8. You should check the installation guide of Laravel here

🅱 Built with

• Laravel - The PHP Framework For Web Artisans
• Laravel Passport - Laravel Sanctum provides a featherweight authentication system for SPAs and simple APIs.
• Laravel Permission - Associate users with permissions and roles.
• Swagger - Generate interactive OpenAPI documentation for your RESTful API
• Laravel File Manager - Integration with TinyMCE
• 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

# Clone the project
git clone https://github.com/maingocthanhtan96/LaraJS.git

# Init project
# https://github.com/beyondcode/laravel-er-diagram-generator
# Generate diagram erd (Optional)
https://graphviz.org/download/ #(install graphviz)
php artisan generate:erd public/images/diagram-erd.png

# Run docker
cd docker
cp .env.example .env
docker-compose up -d
docker compose exec app sh setup.sh

# Run bash script to install project (recommend)
chmod u+x setup.sh && ./setup.sh

# OR hand install
composer install
composer dump-autoload

# Create .env from .env.example
cp .env.example .env

# Generate application key
php artisan key:generate

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

# install dependency
npm install && npm install -g cross-env && npm rebuild node-sass

# Generate file lang
php artisan vue-i18n:generate

# Generate ide
php artisan ide-helper:generate

# Config Virtual host
Exemple: http://local.larajs.com
# Generate Passport secret key
php artisan passport:install

# Copy and paste passport client secret with id=2
PASSPORT_CLIENT_SECRET

# Develop for be
npm run dev # or npm run watch
# Build on production
npm run prod
# Develop for fe
npm run dev-fe # or npm run watch-fe
# Build on production
npm run prod-fe
# Build pro all(be,fe)
npm run prod-all

# Run swagger
./swagger.sh

# username, password
- Amin
username: [email protected]
password: Admin@123!
- Manager
username: [email protected]
password: Admin@123!
- Visitor
username: [email protected]
password: Admin@123!
- Creator
username: [email protected]
password: Admin@123!
- Editor
username: [email protected]
password: Admin@123!
- Developer
username: [email protected]
password: Admin@123!

⚖️ License

MIT license.

Copyright (c) 2019-present maingocthanhtan96