Fullstack Jobs

Fullstack Jobs is a Next.js job board that surfaces curated software roles and company profiles from JSON datasets generated by the scraper tooling in this repository.

Use the Site

You can use this project in either of the following ways:

• Run it locally by following the steps in Getting Started.
• Visit the deployed version at fullstackjobs.dev.

Prerequisites

• Node.js 20+
• npm (or yarn/pnpm/bun)

Getting Started

1. Install dependencies:

npm install

2. Run the development server:

npm run dev

3. Open http://localhost:3000 in your browser.

Available Scripts

• npm run dev - Start the Next.js dev server.
• npm run build - Build for production.
• npm run start - Run the production server.
• npm run lint - Run ESLint.

Main Routes

• / - Job listings
• /companies - Company listings

Data Source

The site reads data directly from JSON files through app/data.ts:

• scraper/jobs/data/jobs-info.json
• scraper/companies/data/companies-info.json

If you update these files, the UI reflects the new content on the next reload.

Optional: Scraper Setup

If you plan to run scraper tools, create a .env file with:

SERP_API_KEY=your_serp_api_key
OPENAI_API_KEY=your_openai_api_key
ZENROWS_API_KEY=your_zenrows_api_key

Scraper code lives under scraper/ (companies, jobs, apis, tests, and utilities).

Project Structure

app/        Next.js app router pages and UI components
scraper/    Data collection, normalization, and utility scripts