How gurungsh/job-tracker works
Job-tracker is a personal job-application management web app. Users create and track applications in a stage-based board or searchable, filterable table, then manage an application's details, timeline, requirements, and company contacts. The React client calls an Express API; shared schemas and types align the two sides, and the server persists data in SQLite. The README documents themes, archiving, and the built-in guide. Some subsystem links rely on README architecture descriptions and source-index references rather than sampled implementations.
Main entry points: app.ts Express app · App.tsx Routes and provider · ApplicationDetailPage.tsx Application detail · ApplicationsPage.tsx Application views
Components 26
Web client
- Routes and provider
apps/client/src/App.tsx - App shell
apps/client/src/components/AppShell.tsx - Application views
apps/client/src/components/ApplicationsPage.tsx - Stage board
apps/client/src/components/Board.tsx - Search and table
apps/client/src/components/TableView.tsx - User guide
apps/client/src/components/UserGuidePage.tsx - Application state
apps/client/src/lib/useApplications.tsx - API client
apps/client/src/lib/api.ts
API and persistence
- Express app
apps/server/src/app.ts - Application routes
apps/server/src/applications/router.ts - Application storage
apps/server/src/applications/store.ts - Activity routes
apps/server/src/activities/router.ts - Activity storage
apps/server/src/activities/store.ts - Contact routes
apps/server/src/contacts/router.ts - Contact storage
apps/server/src/contacts/store.ts - Requirement routes
apps/server/src/requirements/router.ts - Requirement storage
apps/server/src/requirements/store.ts - SQLite database
apps/server/src/db.ts - Request and event logs
apps/server/src/logger.ts
Application domain
- Application detail
apps/client/src/components/ApplicationDetailPage.tsx - Application editor
apps/client/src/components/ApplicationDialog.tsx - Activity timeline
apps/client/src/components/Timeline.tsx - Requirements checklist
apps/client/src/components/Requirements.tsx - Company contacts
apps/client/src/components/Contacts.tsx
Shared contracts
- Types and validation
packages/shared/src/applications.ts
Other components
- Job seeker
Connections 34
- Job seeker → Routes and provider: uses
- Routes and provider → App shell: wraps routes
apps/client/src/App.tsx - Routes and provider → Application views: routes to
apps/client/src/App.tsx - Routes and provider → Application detail: routes to
apps/client/src/App.tsx - Routes and provider → User guide: routes to
apps/client/src/App.tsx - Application views → Stage board: renders
apps/client/src/components/ApplicationsPage.tsx - Application views → Search and table: renders
apps/client/src/components/ApplicationsPage.tsx - Application views → Application state: reads
apps/client/src/components/ApplicationsPage.tsx - Stage board → Application state: reads
apps/client/src/components/Board.tsx - Application detail → Activity timeline: renders
apps/client/src/components/ApplicationDetailPage.tsx - Application detail → Requirements checklist: renders
apps/client/src/components/ApplicationDetailPage.tsx - Application detail → Company contacts: renders
apps/client/src/components/ApplicationDetailPage.tsx - Application detail → Application editor: opens editor
apps/client/src/components/ApplicationDetailPage.tsx - Application state → API client: loads data
apps/client/src/lib/useApplications.tsx - Activity timeline → API client: manages entries
apps/client/src/components/Timeline.tsx - API client → Express app: JSON over API
- Types and validation → API client: types requests
apps/client/src/lib/api.ts - Types and validation → Application routes: validates input
apps/server/src/applications/router.ts - Express app → Application routes: mounts routes
apps/server/src/app.ts - Express app → Activity routes: mounts routes
apps/server/src/app.ts - Express app → Contact routes: mounts routes
apps/server/src/app.ts - Express app → Requirement routes: mounts routes
apps/server/src/app.ts - Application routes → Application storage: calls
apps/server/src/applications/router.ts - Activity routes → Activity storage: calls
apps/server/src/activities/router.ts - Activity routes → Contact storage: checks contact
apps/server/src/activities/router.ts - Contact routes → Contact storage: calls
apps/server/src/contacts/router.ts - Requirement routes → Requirement storage: calls
apps/server/src/requirements/router.ts - Application storage → Activity storage: records stage changes
apps/server/src/applications/store.ts - Application storage → SQLite database: reads and writes
- Activity storage → SQLite database: reads and writes
- Contact storage → SQLite database: reads and writes
- Requirement storage → SQLite database: reads and writes
- Express app → Request and event logs: logs requests
apps/server/src/app.ts - Job seeker → User guide: opens guide