Ditto

A full-stack job application tracker built with Go and Next.js.

---

Job searching means juggling dozens of applications, interview rounds, coding challenges, and follow-ups across spreadsheets, emails, and sticky notes. Ditto brings all of that into one place — a clean web app where you can track every application from first click to final offer, log interview details while they're fresh, and keep your prep materials organized.

Features

• Application Management — Track applications through a status workflow (applied → interviewing → offered → accepted/rejected) with company details, notes, and file attachments
• Interview Tracking — Log each interview round with interviewers, questions asked, your answers, preparation notes, and self-assessments
• Technical Assessments — Track coding challenges and take-home assignments with submissions via GitHub links, file uploads, or notes
• Dashboard & Timeline — At-a-glance statistics, upcoming interviews and deadlines, and a chronological activity feed
• Search & Export — Full-text search across applications, interviews, and assessments; CSV export for offline analysis
• Notifications — In-app notification center with configurable preferences per event type
• File Storage — S3-backed file uploads for resumes, cover letters, and prep documents with per-user storage quotas

Tech Stack

Layer	Technology
Backend	Go 1.24 / Gin
Frontend	Next.js 14 / React 18 / TypeScript
Database	PostgreSQL 15+
File Storage	AWS S3
Auth	JWT + NextAuth v5 beta (GitHub, Google OAuth)
Styling	Tailwind CSS v4 / shadcn/ui
Testing	Go testify / Jest + React Testing Library

Prerequisites

• Go 1.24+
• Node.js 18+
• pnpm
• PostgreSQL 15+
• golang-migrate CLI
• AWS S3 bucket (or LocalStack for local dev)

Quick Start

1. Clone and install dependencies

git clone <repo-url>
cd ditto

# Backend
cd backend
go mod download

# Frontend
cd ../frontend
pnpm install

2. Set up PostgreSQL

Create development and test databases:

createdb ditto_dev
createdb ditto_test

Or use Docker:

docker-compose up -d db

3. Configure environment variables

Backend — create backend/.env:

# Database
DB_HOST=localhost
DB_PORT=5432
DB_USER=ditto_user
DB_PASSWORD=ditto_password
DB_NAME=ditto_dev
DB_SSLMODE=disable

# Test database
TEST_DB_HOST=localhost
TEST_DB_PORT=5432
TEST_DB_USER=ditto_user
TEST_DB_PASSWORD=ditto_password
TEST_DB_NAME=ditto_test

# Auth
JWT_SECRET=your-jwt-secret-change-in-production

# Server
PORT=8081
GIN_MODE=debug                # Set to "release" for production

# Database connection string (alternative to individual DB_* vars above)
# DATABASE_URL=postgres://user:pass@host:5432/dbname?sslmode=disable

# File storage (S3 or LocalStack)
AWS_REGION=us-east-1
AWS_S3_BUCKET=ditto-files-local
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_ENDPOINT=http://localhost:4566   # LocalStack endpoint; omit for real S3

Frontend — create frontend/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8081

AUTH_SECRET=generate-with-npx-auth-secret
NEXTAUTH_URL=http://localhost:8080

# OAuth providers (optional)
AUTH_GITHUB_ID=your-github-client-id
AUTH_GITHUB_SECRET=your-github-client-secret
AUTH_GOOGLE_ID=your-google-client-id
AUTH_GOOGLE_SECRET=your-google-client-secret

4. Run database migrations

cd backend
migrate -path migrations -database "postgres://ditto_user:ditto_password@localhost:5432/ditto_dev?sslmode=disable" up

5. Start the application

# Terminal 1 — Backend (port 8081)
cd backend
go run cmd/server/main.go

# Terminal 2 — Frontend (port 8080)
cd frontend
pnpm dev

Open http://localhost:8080 to access the application.

6. Verify

# Health check
curl http://localhost:8081/health
# → {"data":{"status":"ok"}}

Running Tests

Backend

cd backend

# Run all tests
go test ./...

# Run with sequential execution (required when running handler + repo tests together)
go test -p 1 ./...

# Run with coverage
go test -cover ./...

# Run specific package
go test ./internal/repository -v
go test ./internal/handlers -v

Frontend

cd frontend

# Run all tests
pnpm test

# Run in watch mode
pnpm test -- --watch

Project Structure

ditto/
├── backend/
│   ├── cmd/server/          # Application entrypoint
│   ├── internal/
│   │   ├── handlers/        # HTTP request handlers
│   │   ├── middleware/       # Auth, error handling, security
│   │   ├── models/          # Data structures
│   │   ├── repository/      # Database operations
│   │   ├── routes/          # Route registration
│   │   ├── services/        # Business logic (S3, notifications)
│   │   └── testutil/        # Test helpers and fixtures
│   ├── migrations/          # SQL migration files
│   └── pkg/                 # Shared packages (errors, response)
├── frontend/
│   ├── src/
│   │   ├── app/             # Next.js App Router pages
│   │   ├── components/      # React components
│   │   ├── hooks/           # Custom React hooks
│   │   ├── lib/             # Utilities, API client, schemas
│   │   ├── contexts/        # React contexts
│   │   ├── providers/       # Context providers
│   │   └── types/           # TypeScript type definitions
│   └── __mocks__/           # Jest mocks
├── docs/                    # Detailed documentation
│   ├── architecture.md      # System design and ADRs
│   ├── api-contracts-backend.md
│   ├── database-schema.md
│   ├── development-guide.md
│   ├── deployment-guide.md
│   └── planning/            # BMAD workflow artifacts (PRD, epics, stories)
└── docker-compose.yml

Documentation

Detailed documentation lives in the /docs folder:

• Architecture Overview
• Backend Architecture
• Frontend Architecture
• API Contracts
• Database Schema
• Development Guide
• Deployment Guide

License

MIT