Mentoring Junior Node Devs

Junior developers on Node.js teams hit the same walls: async control flow, connection pool metrics, and where errors actually surface. Structured mentoring turns those walls into career growth.

Recipe

Quick-reference recipe card - copy-paste ready.

Week 1-2: Read codebase - trace one HTTP request + one queue job
Week 3-4: Fix bug with tests (pair on async errors)
Week 5-6: Add endpoint with Zod validation + integration test
Week 7-8: Ship small feature behind feature flag
Week 9+:  On-call shadow; own module with review

Weekly 30-min 1:1 agenda:

1. What was confusing this week?
2. Review one PR they wrote (teach, don't takeover)
3. One skill focus (e.g. read Grafana pool panel)
4. Blockers to escalate

When to reach for this:

• New hire on API squad
• Intern converting to full-time
• Mid engineer pivoting from frontend to Node path

Working Example

Exercise: Trace Async Failure

// src/orders/get-order.ts - give junior broken version
export async function getOrder(id: string) {
  const row = await db.order.findUnique({ where: { id } });
  if (!row) return null;
  enrichWithCustomer(row); // BUG: missing await
  return row;
}
 
async function enrichWithCustomer(order: { customerId: string; customer?: unknown }) {
  order.customer = await db.customer.findUnique({ where: { id: order.customerId } });
}

Mentor prompts:

1. Run test - why is customer sometimes undefined?
2. Add ESLint no-floating-promises - what fires?
3. Fix with await enrichWithCustomer(row)
4. Add test asserting customer populated

Exercise: Read Pool Metrics

Grafana panel homework:
  - pg_pool_total_count
  - pg_pool_idle_count
  - pg_pool_waiting_count
 
Questions:
  - waiting_count > 0 for 5 min means what?
  - Should we raise max or fix slow queries first?

• Juniors learn Postgres before blaming Node event loop
• Link Connection Pool Tuning

Deep Dive

Node-Specific Junior Pitfalls

Pairing Calendar

Feedback Framework

SBI: Situation - Behavior - Impact
"SBI: In yesterday's PR, the query used string concat (behavior),
 which would fail security review and risks SQL injection (impact).
 Let's fix with $1 params together."

• Praise specific growth: "You caught the missing await in review"

Reading List (Ordered)

1. Node.js Basics
2. Express Basics or Fastify Basics
3. Testing Basics
4. Request Correlation IDs
5. Queues Basics

Gotchas

• Sink-or-swim on-call - Anxiety without context. Fix: Shadow two rotations before solo page.
• Only bug fixes - No growth narrative. Fix: Graduated feature ownership plan.
• Mentor always takes over PR - Junior learns dependency. Fix: Comment; junior pushes fix.
• Skipping pool fundamentals - ORM hides too much. Fix: One week raw pg or Prisma metrics exercise.
• No written goals - Promotion surprises. Fix: Shared doc with quarterly skills checklist.

Alternatives

FAQs

Related

• Tech Lead Basics on Node - TL responsibilities
• Code Review Standards - what good PRs look like
• Onboarding Basics - day-one setup
• Skills Matrix - skill tracking
• Pairing on API PRs - pairing norms

Stack versions: This page was written for Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, and NestJS 11.