BZN

Running the project

0. Make sure you have Composer & PHP installed!
1. Open a terminal in the root folder and run $ composer install and $ npm install.
2. Copy the .env.example file and name the new file .env.
3. Make sure the database credentials in your new .env file match your actual credentials.
4. (on first time running) Run 'php artisan migrate:fresh --seed' to insert default data
5. Run $ php artisan serve in your terminal.
6. Run $ npm run hot in another terminal.
7. Voilà! View the project at http://localhost:8000

Testing the project

Browser tests are located in ~/tests/Browser/.

0. Copy env file $ cp .env .env.dusk.local and edit DB_DATABASE, DB_USERNAME, DB_PASSWORD
1. Create a testing database with a testing user according to .env.dusk.local
2. Build Vue assets:
3. $ npm run production
4. Serve the project in testing mode:
5. $ php artisan serve --env=dusk.local
6. Running tests:
7. Running all browser tests: $ php artisan dusk.
8. Running a specific test: $ php artisan dusk [file] e.g. $ php artisan dusk tests/Browser/MapTest.php

For more information about browser testing, read the Dusk documentation.

Linting the project

$ npm run lint

Common issues

Due to PHP being PHP, there are some common issues we will face which are resolved pretty easily.

• Target class does not exist.

1. Run $ composer dump-autoload in your terminal.

• Generic NPM errors

1. Remove /node_modules.
2. Run $ npm ci.

• Generic Composer errors

1. Remove /vendor.
2. Run $ composer install.

• Running tests: 'Facebook\WebDriver\Exception\SessionNotCreatedException: session not created: Chrome version must be between 70 and 73'

1. php artisan dusk:chrome-driver 72