Prerequisites:
- PHP 7.1.3 or higher
- composer
- npm/yarn
When using yarn you can change all npm commands into their corresponding yarn commands.
Steps
- Clone the repo
- Install the required PHP libraries
composer install
- Install the required JS libraries
npm install
cp .env.example .env
- Generate an application key:
php artisan key:generate
- Modify the .env file and make sure a suitable database driver is setup. When you do not have a running database server, you can use the sqlite driver. For details see the Laravel documentation
- Modify the env file and setup
GITHUB_CLIENT_ID
andGITHUB_CLIENT_SECRET
. How to get these keys? - Apply changes to the database:
php artisan migrate
- Generate the front end code (compiling SCSS files, bundeling up js files):
npm run dev
- Serve the application.
php artisan serve
, Valet or Homestead
When modifying the front end code (resources/js/... or resources/css/...) you have to make sure that you are recompiling your code.
You can do this by running one of the following commands:
npm run hot
: Enables hot reloading (see changes without refreshing the page)npm run watch
: Does the same asnpm run dev
but listens for changes on the filesystem. A refresh of the page is still required before the changes take effect.npm run dev
: Compile the js and css files for development environmentnpm run prod
: Compile the js and css files for production
For more information about Laravel click here
For more information about Vue click here
For more information about Bootstrap Vue click here
We rolled a custom persistent login for Vue.
It is better to use a tested package like vue-auth
On the server we implemented a basic token authorization. Using something like json webtokens might provide a more robust solution for your use case.