Documentation

Build with Plavist

Plavist is open source. Self-host the stack, contribute features, or use the managed cloud when you want interviews that scale without losing the human plan.

Getting started

You need both repositories running locally. Node.js 20+ is recommended.

1. Clone

git clone https://github.com/whoshriyansh/plavist_server.git
git clone https://github.com/whoshriyansh/plavist_client.git

2. Server

cd plavist_server
cp env.example .env
# fill MongoDB, JWT, Redis, and optional AI / payment keys
npm install
npm run dev
# API on http://localhost:8001

For local open-source development, set WAITLIST_ACTIVE=false in .env so registration works.

3. Client

cd plavist_client
cp .env.example .env.local
npm install
npm run dev
# app on http://localhost:3000

Set NEXT_PUBLIC_WAITLIST_ACTIVE=false locally if you need the register flow. Cloud/waitlist mode defaults to on.

Prerequisites

  • MongoDB (local or Atlas)
  • Redis (for queues / realtime interview jobs)
  • Optional: AWS S3/SES, Razorpay, GCP Vertex for full AI features

Full contributor workflow lives in Contributing.