NJ Civil Service Navigator

Why I Built This

When I started managing a team at the New Jersey Department of Community Affairs, I quickly learned that hiring through civil service isn’t straightforward. Need to fill a data analyst position? You’re searching through thousands of job specifications, trying to figure out which title code matches what you actually need. Want to promote someone? Good luck finding where their current title leads without clicking through endless PDFs on the Civil Service Commission website.

I kept a browser tab permanently open to their specifications page and built mental maps of which titles connected to which. That’s not a system—that’s institutional knowledge trapped in individual heads. So I built NJ Civil Service Navigator to make what I’d learned accessible to everyone who needs it.

The Problem

New Jersey’s civil service system governs employment for tens of thousands of positions across state agencies, counties, and municipalities. The specifications are public, but the information architecture makes them hard to use:

If you’re looking for a job:

• You search for “analyst” and get dozens of results with no way to tell which ones match your background
• Career paths between titles aren’t documented anywhere—you have to know someone who knows
• The difference between competitive, non-competitive, and unclassified positions matters for job security, but good luck finding a clear explanation

If you’re doing the hiring:

• Finding the right title for a position means reading through specification after specification
• Writing job postings requires manually copying qualification requirements from PDFs
• Explaining to candidates why they need specific experience “or equivalent” takes time you don’t have

What It Does

For Job Seekers

I built the tools I wished existed when I was figuring out the civil service system myself:

• Fuzzy Search: Type “data analyst” or “analysist” (typo included) and find relevant titles. The search understands what you mean, not just what you typed.
• Career Path Explorer: See how titles connect. An Administrative Analyst 1 can promote to Administrative Analyst 2, but can also lateral to certain Program Specialist positions. Those connections are now visible.
• Resume Matcher: Upload your resume and see which specifications best match your experience. Useful for finding titles you hadn’t considered.
• Classification Guides: Plain-language explanations of what “competitive” actually means for your job security.

For HR and Hiring Managers

These features exist because I needed them and couldn’t find them:

• Job Posting Generator: Select a specification and get a compliant job posting with all the required language. I used to copy-paste from PDFs—now it takes one click.
• Org Chart Builder: Drag-and-drop org chart creation using actual civil service titles. Each box links to its full specification.
• Side-by-Side Comparison: Evaluating whether to hire an Administrative Assistant 2 or an Administrative Assistant 3? Compare the specs directly.
• Pension Reference: Quick lookups for PERS and PFRS information that always come up during interviews.

Technical Details

The entire database of 5,128+ specifications loads client-side. Search is instant—no waiting for server responses. I used:

• React 18 with TypeScript
• Vite 6 for builds
• Fuse.js for fuzzy search
• Tailwind CSS with shadcn/ui components
• PWA capabilities so it works offline

Data updates monthly from official Civil Service Commission sources. I wrote scrapers to pull the specifications and transform them into a searchable format.

Why It Matters

Civil service exists to ensure merit-based hiring in government—to prevent patronage and protect workers. But when the system is hard to navigate, it creates its own barriers. People who don’t have connections in state government, who haven’t figured out the unwritten rules, are at a disadvantage.

I built this because I had the technical skills to solve a problem I experienced directly. The specifications were always public; they just weren’t usable. Now they are.