maingocthanhtan96/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

larajs's Issues

Problem with installation script in README.md

The issue is in README.md

# Clone the project and run composer
git clone git remote add origin https://github.com/maingocthanhtan96/LaraJS.git

Should be change to:

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

source-map in production

Hi @maingocthanhtan96,

Anh mới lượn một vòng, thấy em có tâm huyết với dự án quá. :D cũng khá là nhiều commit. 👍

if (isProduction) {
  mix.version();
} else {
  mix.sourceMaps().webpackConfig({
    devtool: 'eval-cheap-source-map', // Fastest for development
  });
}

Khúc này là build cho frontend, thực tế là nên có source-map để việc debug trên production dễ dàng hơn. Tuy nhiên sẽ có một vài ý nhỏ ở đây:

• Sourcemap chỉ được load khi mở Debugger (F12) nên không sợ load quá nhiều
• Nếu một người biết về Debugger thì sẽ đọc được source code khi có source-map? Điều này là đúng, nhưng đối với production, mình sẽ secure các đường dẫn source-map bằng auth-header / VPN. Chỉ người có quyền thì mới có quyền inspect những file này.
• Thực ra khi deploy mình cũng không cần thiết phải deploy những file source-map, mình có thể sử dụng một số tools khác như sentry (open-source) để tracking. Sau khi mình build -> collect source-map -> upload lên sentry. Như vậy thì khi nào có issue sẽ inspect dễ dàng hơn khi không có source-map