Job Application Tracker

Project Overview

This is a modern Job Application Tracker built using React, TypeScript, and Tailwind CSS. The project follows Test-Driven Development (TDD) principles, utilizing Vitest and React Testing Library for comprehensive unit and component testing.The application manages job applications locally, with an architecture designed for seamless integration with external services like Google Sheets.

Project Status

Completion: 98%

This project is feature-complete for its core functionality. Based on the project recommendations, 48 out of 48 planned features have been implemented and are fully tested. The test suite has 680+ tests (66 test files) with Vitest and React Testing Library.

Recent Updates

• Backend API as Mini-Framework: The PHP API (/api) is now a small framework with a single entry point (index.php), router, controllers, and helpers. All endpoints are under /api/* (auth, captcha, suggestions, google-sheets). See DOCS/API.md for routes and structure.
• OAuth Authorization Code + Token Refresh: Login uses the authorization-code flow; the backend exchanges the code for access and refresh tokens and stores them in HTTP-only cookies. When the access token expires, the backend refreshes it automatically (Sheets proxy and GET /api/auth/cookie use a valid token). Requires GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET on the server.
• Application Fields: Location, Work Type, Hybrid Days: JobApplication now includes optional location, workType (remote / on-site / hybrid), and when hybrid, hybridDaysInOffice (1–5 days per week). Form, table, and opportunity-to-application conversion support these fields.
• Email Scan (Gmail): In Settings, scan Gmail for application-related emails; preview proposed additions and updates, then apply selected items to the tracker. Handles rate limits with a clear message and chunked fetching.
• AI-Powered Job Matching: Deterministic scoring engine plus Gemini AI for profile synthesis and job scoring. MatchScoreBadge, breakdown modal, profile setup wizard, and matching settings (accessible from Settings → 🤖 Matching). Core logic, types, persistence, Zustand store, and all UI components complete. Pending: UI integration on OpportunitiesPage (T12) and HomePage (T14) — see DOCS/MATCHING_IMPLEMENTATION_TASKS.md.
• PWA: The app is installable as a Progressive Web App (manifest, service worker). Install from the browser on desktop and mobile when served over HTTPS.
• i18n Test Mock: Test setup loads the English translation JSON and flattens it for the react-i18next mock, avoiding duplicated translation strings in tests.
• Zustand State Management: Global state with Zustand stores for applications, opportunities, preferences, and authentication.
• Full Internationalization (i18n): Bilingual experience (English/Spanish) with i18next across the app.
• Support & Suggestions System: Support page with suggestion form, PHP + SQLite backend, and numeric CAPTCHA.
• Direct ATS Search: Opportunities page generates targeted Google search queries for major ATS (Ashby, Greenhouse, Lever, Workable, Workday, etc.).
• Mobile-First Responsive Design: Card-based table on mobile, compact metrics, adaptive header and login button.
• Test Infrastructure: 680+ tests passing with Vitest and happy-dom.

Next Steps

• Complete matching UI integration: add MatchScoreBadge + RecommendationPanel to OpportunitiesPage and HomePage (see DOCS/MATCHING_IMPLEMENTATION_TASKS.md T12, T14)
• Browser notifications for interviews and follow-ups
• Export to PDF/CSV and enhanced data import