Installation

From the downloaded files to a running gym site in about five minutes.

1. Install the packages

You need Node.js 22.18 or newer (see Requirements). In the project folder:

npm install

2. Create your settings file

cp .env.example .env

Open .env and change at least these lines:

AUTH_SECRET="paste-a-long-random-string-here"
HEAD_COACH_EMAIL="you@your-gym.om"
HEAD_COACH_PASSWORD="a-strong-password"

Generate a good secret with:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Every variable is explained in Environment variables.

3. Create the database and the sample gym

npm run setup

This runs prisma generate, prisma db push (creates the tables in prisma/liyaqa.db) and npm run db:seed: gym settings, plans, the head coach from .env, four more coaches, 30 members with 90 days of workouts, meals, sleep, steps, heart rate and weigh-ins, programs, exercises, foods, meal plans, groups, posts, challenges and badges. The seed only fills an empty database, so running it again is safe.

The sample logs end on the day you seed. To refresh them later (for a demo, say), wipe and seed again:

npm run db:reset

4. Run it

npm run dev
Address What
http://localhost:3306 redirects to the Arabic site /ar
http://localhost:3306/en English site
http://localhost:3306/en/login sign in (Member or Coach)
http://localhost:3306/en/member member dashboard
http://localhost:3306/en/coach coach dashboard
http://localhost:3306/en/docs this documentation

Sample accounts

All sample passwords are SAMPLE_PASSWORD from .env (liyaqa-demo-2026 by default).

Account Role
HEAD_COACH_EMAIL (coach@liyaqa.test) Head coach: sees everything
maryam@liyaqa.test, faisal@liyaqa.test, noor@liyaqa.test, hamood@liyaqa.test Coaches: see only their own clients
DEMO_MEMBER_EMAIL (member@liyaqa.test) Member (Yousef, coached by the head coach)
aisha@liyaqa.test, ahmed@liyaqa.test… the other 29 members

Set DEMO_HINT="1" to show the demo sign-ins on the sign-in page.

5. Check it

npm run lint     # TypeScript
npm test         # unit tests of the fitness rules, roles and drafts
python scripts/e2e_api.py      # end-to-end API test against the running server
python scripts/check_pages.py  # every page in both languages answers 200

Next: Manual setup and deployment.