job-board

Local-first job application tracker. Automates job feed ingestion from Apify and provides a reactive interface for managing applications through their lifecycle.

Prerequisites

• Go 1.24+
• Node.js 18+
• npm
• An Apify API token (for job feed syncing)

Setup

1. Install frontend dependencies:

cd frontend && npm install

2. Create a .env file in the project root from the example:

cp .env.example .env

3. Edit .env and add your Apify API token:

APIFY_API_TOKEN=your_token_here

4. (Optional) Edit config.json to customize job search parameters — title keywords, location, exclusions, etc.

Running

Start both backend and frontend in one command:

make dev

• Frontend: http://localhost:5173
• Backend API: http://127.0.0.1:8080

To run them separately:

make dev-backend    # Go backend only (port 8080)
make dev-frontend   # SvelteKit dev server only (port 5173)

Building

make build            # Build both backend and frontend
make build-backend    # Build Go binary only (outputs backend/job-board)
make build-frontend   # Build static frontend only (outputs frontend/build/)

Cleaning

make clean    # Remove build artifacts

Project Structure

├── backend/        # Go REST API + SQLite database
├── frontend/       # SvelteKit 5 + Tailwind CSS
├── config.json     # Apify job search parameters
├── .env            # API tokens (gitignored)
└── Makefile        # Dev/build commands