Premium Job Board & Career Site Theme Built with Astro 7 + Tailwind CSS + TypeScript + React

| Career mode | Dark mode | Mobile |
|---|---|---|
| | |
SwiftJobs is a premium Astro 7 theme for job boards, company career pages and recruitment agencies. It combines fast, SEO-friendly static pages with React islands for interactive job filtering.
It has one brand rule: every listing shows its pay range. Jobs are typed content collections, so a listing without a salary does not build, and every job page ships structured data for Google Jobs.
| Technology | Role |
|---|---|
| Astro 7 | Fast static output, SEO first |
| Tailwind CSS 4 | Utility-first styling, CSS design tokens, container queries |
| Motion | Layout animation in islands (filters, wizard), respects reduced motion |
| TypeScript | Strict type checking across the project |
| React | Interactive islands for filters and forms |
| Satori + sharp | Open Graph images for every job and company, rendered at build time |
| Decap CMS | Admin panel at /admin to manage jobs and companies through Git |
10 page types, each in English (/) and Bahasa Indonesia (/id/):
HomeJobs: filter sidebar and paginationJob/[slug]: job detail and pay comparisonCompaniesCompany/[slug]: company profilePost a Job: pricing plans and a multi-step wizardDashboard: saved jobs, alerts, applicationsCompare: saved jobs side by sideContact404Plus rss.xml, feed.json, jobs.json, Open Graph images at /og/*.png, a sitemap and robots.txt.
.env| Feature | Description |
|---|---|
| ๐ Advanced filtering | Filter by field, workplace, job type, minimum pay and company, kept in the URL |
| ๐งฉ JSON-LD JobPosting | Structured data for Google Jobs, including the pay range |
| ๐ Rich-text job descriptions | Markdown with custom typography |
| โญ Saved jobs | Save jobs in the browser, then compare them |
| ๐ช Multi-step posting | Six-step "Post a job" wizard with a live preview and pricing plans |
| ๐ Skeleton loading | Loading and empty states for the job feed |
| ๐ผ๏ธ Social images | A 1200ร630 pay stub image for every job, salary included |
| ๐ฑ Pay display | Visitors read every salary in one currency and period (for example IDR per month) |
| ๐ Pay comparison | "Pays more than 67% of Design roles" plus a pay distribution strip on job pages |
| โ๏ธ Compare | Up to four saved jobs side by side |
| ๐ Job alerts | "Get alerts for this search" from any filter, managed in the dashboard |
| ๐ Two languages | English and Bahasa Indonesia, with hreflang and localized numbers and dates |
| ๐จ 3 color presets | Signal (orange), Cobalt (blue), Volt (lime), all WCAG AA |
| โจ View transitions | Job titles and logos move from the list to the job page (native CSS, no JS) |
| ๐ฐ RSS and JSON Feed | Job feeds for aggregators, with structured pay data |
| ๐๏ธ Decap CMS | Manage content without touching code |
| ๐ณ Stripe Payment Links | Take payment for postings without a server |
The whole visual language comes from the pay-first rule:
| Signature | What it is |
|---|---|
| Pay stub | Pay sits on a perforated ticket stub, on cards and on job pages |
| Signal swipe | A slanted accent block behind one key word in a headline |
| Signal duotone | Every photo is rendered ink-on-accent, so any photo looks on brand |
| 12ยฐ slant | Logo, active nav bar, Featured tags, bullets and stepper share one angle |
Palette: cool green-grey neutrals with one "Signal" orange accent. Type: Bricolage Grotesque (display), Geist (UI), Geist Mono (numbers and pay). Light and dark themes, text contrast checked against WCAG AA. Full details in design-system/swiftjobs/MASTER.md.
Requires Node.js 22.12 or newer.
npm install
npm run dev # http://localhost:4321
npm run build # astro check + static build to dist/
npm run preview
The full guide is in the docs/ folder. Read it on GitHub or in your editor; the demo build also publishes it at /docs.
| Guide | What it covers |
|---|---|
| Getting started | Install, run, build, project structure, scripts |
| Customization | Brand, colors, fonts, copy, languages, photos |
| Jobs and companies | Content schema and the Decap CMS |
| Career mode and ATS import | One-company career sites; Greenhouse, Lever and Ashby import |
| Forms and payments | Form services, job alerts, Stripe Payment Links |
| Deployment | Netlify, Vercel, static hosts, build variables, the demo |
| Quality and testing | Tests, accessibility audits, Lighthouse results |
| License | What your license allows |
src/
config/site.ts # brand, mode, palette, navigation, currencies, plans, ATS
i18n/ui.ts # every UI string in English and Bahasa Indonesia
content.config.ts # job and company schemas (pay is required)
content/jobs/*.md # one file per job (markdown)
content/companies/ # company profiles (JSON)
styles/global.css # --sj-* design tokens, presets, signature components
views/ # page layouts shared by / and /id/
pages/ # routes, feeds, jobs.json, og/*.png, robots.txt
components/jobs/ # PayStubCard, JobRow, SalaryFigure, CompanyMark, PayContext
components/islands/ # JobBoard, PostJobWizard, ApplyForm, CompareJobs, AlertDialog, ...
lib/ats/ # Greenhouse, Lever and Ashby import
lib/og.tsx # Open Graph image design
public/admin/ # Decap CMS (index.html + config.yml)
tests/ # Playwright tests
docs/ # documentation (markdown) and screenshots
design-system/swiftjobs/ # design system documentation
SITE.palette (signal, cobalt, volt), or edit the --sj-* tokens in src/styles/global.css. Social image colors are in OG_COLORS (src/lib/og.tsx).site in astro.config.mjs (used for canonical URLs, hreflang, sitemap, feeds, Open Graph and JSON-LD) and in public/admin/config.yml.src/i18n/ui.ts. To add a language, copy the en object, translate it, register it in LOCALES (src/i18n/index.ts) and i18n.locales (astro.config.mjs), then add routes in src/pages/<code>/. Job content is not translated: it is written by employers..md file to src/content/jobs/, or use the CMS. The build fails if salary is missing.cover in companies.json and the two images in src/views/HomeView.astro.USD_RATES (src/config/site.ts).Copy .env.example to .env. Everything is optional: without an endpoint a form still validates and shows success (demo mode), but sends nothing.
| Variable | Used by | Body |
|---|---|---|
PUBLIC_APPLY_ENDPOINT | Application form (with CV file) | multipart |
PUBLIC_CONTACT_ENDPOINT | Contact page | multipart |
PUBLIC_NEWSLETTER_ENDPOINT | Weekly roles signup on the home page | multipart |
PUBLIC_ALERTS_ENDPOINT | Saved-search alerts | JSON |
PUBLIC_POST_JOB_ENDPOINT | Post a job wizard | JSON |
PUBLIC_STRIPE_LINK_STANDARD / _FEATURED / _TEAM | Plan payments | Payment Link URL |
Recipes:
https://formspree.io/f/<id>. CV uploads need a paid Formspree plan.https://api.web3forms.com/submit and add a hidden access_key input to the forms you connect.Accept: application/json.prefilled_email and client_reference_id (the listing's reference), so payments can be matched to listings.Open /admin/. To edit locally, run npx decap-server in a second terminal and open http://localhost:4321/admin/index.html. On Netlify, enable Identity and Git Gateway; to use GitHub directly, change backend in public/admin/config.yml. CMS fields mirror src/content.config.ts: if you change the schema, update config.yml too.
DEFAULT_MODE in src/config/site.ts, or SWIFTJOBS_MODE=career at build time.DEFAULT_ATS, or SWIFTJOBS_ATS=greenhouse:your-board.Full guide: docs/career-mode.md.
npm run build
npm test
Netlify: netlify.toml is included. Import the repository and deploy; build command, output folder and Node version are already set.
Vercel: import the repository. Astro is detected automatically and the output is static.
Any static host: run npm run build and upload dist/. Serve 404.html for missing pages.
Add your .env variables in the host's environment settings. See docs/deployment.md.
The public demo is two deployments of the same repository:
| Deployment | Environment |
|---|---|
| Job board | SWIFTJOBS_DEMO=1 |
| Career site | SWIFTJOBS_DEMO=1 SWIFTJOBS_MODE=career |
SWIFTJOBS_DEMO=1 turns on the "Theme demo" panel (color presets and mode switch), ?palette= previews and the documentation at /docs. Never set it on a real site.
<div align="center">
One-time purchase, commercial license
</div>
โ ๏ธ SwiftJobs is not free. Contact the seller for a demo and purchase access.
SwiftJobs ยฉ 2026 LessCodex. All rights reserved.
SwiftJobs is commercial software owned by LessCodex, licensed (not sold) under the SwiftJobs Commercial License.
| License type | You may build |
|---|---|
| Personal | One website for yourself or your own company |
| Pro | Unlimited websites for yourself or your own company |
| Agency | Unlimited websites, including for clients |
You may use and modify the theme to build websites within your license type, including commercial ones (for example a paid job board), and hand finished websites to clients (Agency license).
You may not resell, share or publish the theme's source code (including in a public repository); turn it into another template, starter kit or UI kit; sell it on a theme marketplace; build a website builder from it; or remove the LessCodex copyright notices from the source code.
A "by LessCodex" credit on your website is not required. Open-source libraries, fonts and components stay under their own licenses; see THIRDPARTYNOTICES.md.
For licensing, customization or installation questions, contact LessCodex at lesscodex.dev or [email protected].
<div align="center">
Made with โก Astro โข Styled with ๐จ Tailwind โข Typed with ๐ท TypeScript
</div>
By clicking "Pay now," you authorize Polar Software, Inc., our online reseller and merchant of record, to charge your selected payment method the amount shown above, and agree to the Buyer Terms. This is a one-time charge.