Seeer.md

Seeer project

The project consists of 2 repositories, one for the frontend (nodejs vuejs) one for the backend (php laravel). To install the correct versions of php, node etc. just run asdf install and if you dont have asdf installed, shame on you! https://github.com/asdf-vm/asdf and install the asdf plugins for php, nodejs (google is your friend)

Backend

Make sure you have mysql installed brew install mysql (mac) than create a database and make sure the credentials are compliant with the .env file. You can also ask sohail for a production database to have some data.

Clone the repo: https://github.com/sohailnl/seeer-backend

cd seeer-backend
cp .env.example .env # you can ask the current values to Sohail, they live in envoyer
asdf install
composer install
php artisan migrate # run database migration (create tables etc)
php artisan serve

Frontend

Clone the repo: https://github.com/sohailnl/seeer-frontend

cd seeer-frontend
asdf install
npm install
npm run start:local

Now you sould be able to visit http://localhost:8080 and boot the application. To switch the theme, check the config.js

Deployment

We have a app called envoyer https://envoyer.io/auth/login we deploy using this app. It has all the environment vars and all the steps to deploy. Usually its wise to first deploy the backend than the frontend. Just becaust you would like the api to be up to date before deploying the frontend who relies on this.

All the staging applications listen to the develop branch, and all production apps listen to the master branch.

Committing

When committing use the https://www.conventionalcommits.org/en/v1.0.0/ standards, these are handy when we deside to use semantec deployments or extract features from certain commits.