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.