Local setup

Run RealCredi frontend and backend locally.

Local setup

Prerequisites

Node.js 18+
PostgreSQL
Backend on port 4000, frontend on 3000

Backend

cd backend
cp .env.example .env          # DATABASE_URL, JWT secrets, FRONTEND_URL, CORS_ORIGIN
npm install
npx prisma generate
npx prisma migrate deploy     # or migrate dev
npm run db:seed
npm run db:seed-rbac
npm run dev                   # http://localhost:4000

API base: http://localhost:4000/api/v1

Frontend

cd frontend
cp .env.example .env.local    # NEXT_PUBLIC_API_URL=http://localhost:4000/api/v1
npm install
npm run dev                   # http://localhost:3000

Seed users

After db:seed + db:seed-rbac:

Email	Password	Role
`admin@realcredi.com`	`admin123`	SUPER_ADMIN
`instructor@realcredi.com`	`instructor123`	INSTRUCTOR
`student@realcredi.com`	`student123`	STUDENT
`corporate@realcredi.com`	`corporate123`	CORPORATE

There is no seeded EMPLOYER. Register at /auth/register/employer. Career tracks appear via admin UI (/admin/career/tracks) or first career-loop use.

MVP demo script

Log in as admin → ensure tracks at /admin/career/tracks.
Instructor → complete Coach setup until match ready.
Student → intake → match → evidence → publish → open /u/{slug}.
Employer → org → seats invoice → admin marks paid → search → intro.
Confirm /credentials/{code} vs /verify.

More: Product · MVP