Quick Start

From a fresh install to your first placement — in under 15 minutes.

Step 1: Install and run

TalentDesk is a Next.js 14 application. Clone the repository, install dependencies, and run the development server:

git clone https://github.com/mayuresh49/sentinelflux-talentdesk.git
cd sentinelflux-talentdesk
npm install
npm run dev

The application starts at http://localhost:3000. On first launch, it creates a SQLite database file at data/talentdesk.db and seeds a Master Admin account.

Step 2: Add your first client

Navigate to Clients in the sidebar and click Add Client. Fill in:

• Client name and industry
• Primary contact name and email
• Account Manager (assign a user in your team, or yourself)

Save the client. You'll land on the client detail page.

Step 3: Create a hiring need

From the client detail page, click Add Position. Each position requires:

• Role title (e.g. "Senior Backend Engineer")
• Required skills (multi-select from your skills library)
• Experience range (minimum and maximum years)
• Target start date
• Compensation range (optional)

The position is created in Phase 1 of the hiring pipeline (Sourcing). Move it through Phase 2 (Screening) and Phase 3 (Offer) as you progress.

Step 4: Add an engineer to the talent roster

Navigate to Talent and click Add Engineer. Enter their name, email, skills, and years of experience. New engineers default to Bench status.

Step 5: Create a deployment and clear the placement gate

Navigate to Deployments and click New Deployment. Select the client, the position, and the engineer. Set the managing account manager, start date, and allocation percentage.

The deployment is created in "Scheduled" status. Before the engineer can be marked Deputed, open the deployment and go to the Placement Gate tab. Check off all four items:

1. Pre-screen completed
2. Technical bar passed
3. Background check cleared
4. Client alignment confirmed

Once all four are checked, the Mark as Deputed button becomes active. Clicking it transitions the engineer's status to Deputed, triggers the onboarding checklist, and records the event in the audit log.

Step 6: Log the first health signal

Navigate to the deployment and open the Health tab. Log this week's engagement signal — Green, Amber, or Red — with a brief note. The Action Center will flag any active placements that have not had a health update in the past 7 days.