FV-Replowed/fv-replowed

Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1. 1

   Clone the repository

   Needs Git: winget install Git.Git

   git clone https://github.com/FV-Replowed/fv-replowed.git
   cd fv-replowed

   Copy
2. 2

   Install the required runtimes

   Node.js LTS (no version pinned), PHP ^8.2

   winget install CoreyButler.NVMforWindows
   nvm install lts
   nvm use lts
   scoop install php composer  # needs scoop: https://scoop.sh

   Copy
3. 3

   Configure environment variables

   Fill in secrets: APP_KEY, DB_PASSWORD, REDIS_PASSWORD, MAIL_PASSWORD, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, B2_ACCESS_KEY_ID, B2_SECRET_ACCESS_KEY

   Copy-Item .env.example .env

   Copy
4. 4

   Start backing services

   Needs: MariaDB

   winget install Docker.DockerDesktop
   docker compose -f docker-compose.yaml up -d

   Copy

   If you see Cannot connect to the Docker daemon: start Docker Desktop (or the Docker service) first.
5. 5

   Install dependencies

   npm ci
   composer install

   Copy
6. 6

   Set up the database / app

   php artisan key:generate
   php artisan migrate

   Copy
7. 7

   Run it

   Run each command in its own terminal.

   npm run dev
   php artisan serve

   Copy

Makefile targets need make (e.g. winget install GnuWin32.Make) or WSL.