Added Setup Instruction for local development to README

This commit is contained in:
Vari 2024-02-14 23:46:54 +01:00
parent 05fb8b20ff
commit 04b1807bc1
2 changed files with 66 additions and 2 deletions

View File

@ -1,2 +1,63 @@
# Deathgarden_Rebirth-Dashboard
Dashboard for the Deathgarden Rebirth project: https://github.com/wolfswolke/DeathGarden_API_Rebirth
# Deathgarden Rebirth Rewrite
Rewrite of the [Deathgarden rebirth](https://github.com/wolfswolke/DeathGarden_API_Rebirth) project for better maintainability and (hopefully) less bugs.
This project is written in *PHP* with Laravel.
## How to start developing
You don't need much to start developing since you can use laravel sail do quickly get a local dev environment running.
### Prerequisites
- Docker
- Docker-compose
- Linux wsl (Windows)
- Laravel Knowledge
### Step 1 - Clone the Repository
### Step 2 - Install Composer dependencies
Move into the ./dist folder and install the composer dependencies.<br>
If its your first time setting up the project and you dont have composer installed, you can use this command to install them:
```shell
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
```
### Step 3 - Setup .env
Copy and rename the `.env.example` file to .env and fill out your Environment variables
### Step 4 - Starting Sail
Now you can start the sail container with
```shell
./vendor/bin/sail up -d
```
or if you have the sail alias configured
```shell
sail up -d
```
### Step 5 - Setup Database
After starting sail you can run the database migrations with
```shell
sail artisan migrate
```
### Step 6 - Installing JS Dependencias and Compile
First you can install the JS dependencies with
```shell
sail npm install
```
and build the JS with
```shell
# for building files a single time
sail npm run build
# for active developing with vite
sail npm run dev
```

3
dist/.env.example vendored
View File

@ -37,6 +37,9 @@ VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
SAIL_XDEBUG_MODE=develop,debug,coverage
SAIL_XDEBUG_CONFIG="client_host=172.23.0.3"
# Steam url to use for the api call
# Improtant: Dont forget the ending '/'
STEAM_API_URL=https://api.steampowered.com/