Welcome to the official documentation for FlorisBoard Addons Backend. This guide provides comprehensive information on setting up and running the Laravel application for the backend. Follow the steps below to get started with the FlorisBoard Addons Backend.
Before proceeding, ensure that Docker is installed on your system.
-
Copy the .env file:
cp .env.example .env
-
Install Composer Dependencies:
docker run --rm \ -u "$(id -u):$(id -g)" \ -v "$(pwd):/var/www/html" \ -w /var/www/html \ laravelsail/php83-composer:latest \ composer install --ignore-platform-reqs
-
Configure & use these recommended alias:
alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail' alias saila='sail artisan' alias sailp='sail bin pint' alias sails='sail bin phpstan analyze'
-
Run Docker Containers:
sail up
-
Generate Application Key:
saila key:generate
-
Create Local Storage for File Uploads:
saila storage:link
-
Migrate the Database and Seed with Fake Data (for development):
saila migrate && saila migrate:fresh --seed
We recommend to configure these alias for easier development
alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail'
alias saila='sail artisan'
alias sailp='sail bin pint'
alias sails='sail bin phpstan analyze'
Make sure to configure the default alias
We're using laravel pint for code formatting you can run the code formatting using
sailp
We're using larastan for static analysis make sure to run it occasionally to catch bugs
sails
When you want to debug a value instead of using the old dd
you can take advantage
of laravel ray
ray(...$values);
and you can see the result on http://localhost:8000. It's an open source laravel ray compatible service called buggregator.
We're using testing to make sure the logic works with different scenarios so make sure to use
saila test
to see if tests are passing
Access the API documentation by visiting the following link: http://localhost/docs/api
Access the admin panel through the following link: http://localhost/admin
- Email: [email protected]
- Password: password
Access the Mailpit interface using the following link: http://localhost:8025