Job Board Template for Next.js

A free, open-source job board template built with Next.js 16, TypeScript and PostgreSQL, for anyone launching a job board for a niche, industry or community. Job seekers search and filter jobs and apply on the employer's own site, employers post in Markdown and see views and apply clicks, and admins approve every post, with Stripe paid posting off until you add keys.

by Light CloudDirectories and job boards

Build a job board with Next.js and PostgreSQL

Job board home page: climate-tech jobs in Europe with search, filters for role, location, workplace, type and salary, popular tags and a list of jobs with salaries
Job board home page: climate-tech jobs in Europe with search, filters for role, location, workplace, type and salary, popular tags and a list of jobs with salaries, on a phone

Features

  • Search over title, company and tags, with filters for role, country, remote or on-site, job type, minimum salary and tag
  • The filters are a plain HTML form, so the list works without JavaScript and every filtered view has its own URL
  • A yearly salary range on every job in EUR, GBP, CHF, DKK, SEK, NOK or PLN, compared in euros by the salary filter
  • Job pages with JobPosting and BreadcrumbList JSON-LD, an Open Graph image per job, and noindex once a job has ended
  • Employer dashboard with each job's status, views, apply clicks and live dates; Apply counts the click, then redirects
  • Moderation at /admin: approve, send back with a reason, feature, expire now and disable employer accounts
  • Each job is live for 30 days from approval or payment, then leaves the board without a scheduled task
  • sitemap.xml, an RSS feed at /feed.xml and /llms.txt, plus a demo board of 37 jobs that one button clears

Tech stack

What you need

  • A paid plan: deploying creates a PostgreSQL database, which the Free plan does not include
  • To run it locally: Node.js 22.12 or newer, npm, and Docker for a local PostgreSQL
  • No API keys: it starts with nothing to configure
  • Optional: RESEND_API_KEY and EMAIL_FROM to email review decisions and password resets; without them emails go to the server log
  • Optional: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET and STRIPE_PRICE_JOB_POST to charge per post; without them posting is free

About

Every setting is read in src/lib/config.ts, and email, GitHub or Google sign-in and paid posting each switch on only when all of their variables are set, so the board runs on DATABASE_URL and AUTH_SECRET alone. A post's expiry is a date the public queries compare against, which is why nothing has to run on a schedule to take old jobs down. Start with src/lib/site.ts for the board's niche, tagline and FAQ answers and src/lib/catalog.ts for categories, countries and currencies, then clear the demo jobs in Moderation. npm start applies the migrations and seeds the demo once under a PostgreSQL advisory lock, and on Light Cloud each push to your copy redeploys.

FAQ

How do I start a niche job board with Next.js?

Deploy this template, create the first account (it becomes the admin), clear the demo data in Moderation, then set APP_NAME and edit src/lib/site.ts for your niche. Categories, countries and currencies are lists in src/lib/catalog.ts.

Do job board posts show up in Google for Jobs?

Each live job page carries JobPosting structured data with title, description, dates, employer, location or remote area and salary. Whether Google lists a job is up to Google, so check pages with its Rich Results Test.

Can I charge employers to post a job?

Yes. Create a one-off price in Stripe, set STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET and STRIPE_PRICE_JOB_POST, and add a webhook at /api/stripe/webhook. Each post then goes through Stripe Checkout and goes live when the payment clears; without the keys posting is free and every post waits for approval.

How are Markdown job descriptions kept safe?

src/lib/markdown.ts shows raw HTML as text, does not render images and keeps only http, https and mailto links, each with rel="nofollow ugc". Unit tests cover these rules.

Can I host this job board without Light Cloud?

Yes. It is a standard Next.js app with no Light Cloud code: any host with Node.js 22.12 and PostgreSQL runs it with npm run build and npm start once DATABASE_URL and AUTH_SECRET are set.

Price
Free
Framework
Next.js · JavaScript
Updated

Variables

  • AUTH_SECRETGenerated