Setup instructions

This application needs to be installed before continuing.

1. Docker Desktop

Ensure that you have the follow programs installed after following the page instructions:

1. NodeJS
2. GoLang

On Windows it's advised to use the built-in vs-code terminal unless you understand the differences between WSL, Powershell & Command Prompt.

1.a. Install make on windows

As defined here https://chocolatey.org/install

Open Command Prompt as Administrator then run the following commands:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

choco install make

If you struggle here see https://stackoverflow.com/questions/48148664/the-term-execution-policy-is-not-recognized.

1.b. Install make on macos

Make sure that you have brew installed https://brew.sh/

brew install make

2. Fork repository

1. Go to github.com/the-clothing-loop/website and name it something like "clothing-loop".
2. Disable actions in fork (see https://github.com/orgs/community/discussions/26704)
3. Clone repo locally git clone https://github.com/<your_username>/clothing-loop.git
4. Open in VS code, open workspace, installed recommended extensions if asked
5. copy /clothing-loop/server/config.example.yml to same directory and name it config.dev.yml
6. copy /clothing-loop/frontend/.env-example to same directory and name it .env

3. Start using docker compose

1. Open a terminal and cd into clothing-loop
2. Run make docker-start this will setup and start the container, wait till this finishes (if the docker won't start it might help to open Docker Desktop first and try again, see: stackoverflow error-during-connect-this-error-may-indicate-that-the-docker-daemon-is-not-runn)
3. Please skip (currently not working): In new tab run make db-setup to seed the db with dummy data.
4. If you do not have a MYSQL client, install one, like DBeaver (cross-platform, advised), TablePlus (MacOS) or HeidiSQL (Windows). The server is 128.0.0.1 and user: root and password is fb4aeaa6d860dbabe785675e (from docker-compose.yml). The tables should be populated.
5. The frontend should be visible at http://www.clothingloop.localhost:8080/ in your browser of choice.

4. Login

1. Try logging in using host@example.com it will send you a verification email.
2. go to http://localhost:8025/ to see the self hosted inbox (Mailpit), verify from there, now you should be logged in as a "host".

The following dummy accounts are available:

• Super user: admin@example.com
• Host: host@example.com
• Participant: user@example.com

Development links

Name	Link
mailpit	http://localhost:8025/
website	http://www.clothingloop.localhost:8080/
app	http://app.clothingloop.localhost:8080/