How nitinsirsath/career-companion-frontend works
Career Companion is a browser frontend for tracking job applications and the email-derived events and actions associated with them. Users enter through authentication, then use the dashboard to review pending actions and resolve ambiguous or unmatched emails, or manage applications and inspect their histories. A Gmail sync screen exposes mail connection and synchronization controls. The API client and shared contracts form the internal boundary to the backend. Several route implementations were not sampled, so their detailed interactions are shown only where supported by the API surface and repository tree.
Main entry points: client.ts API client · __root.tsx Root route · main.tsx Frontend bootstrap · auth.ts Authentication helpers
Components 14
App shell
- Frontend bootstrap
src/main.tsx - Authentication helpers
src/api/auth.ts - Root route
src/routes/__root.tsx - Theme provider
src/components/ThemeProvider.tsx - Login screen
src/routes/login.tsx
Application tracking
- Application list
src/routes/applications.tsx - Application detail
src/routes/applications.$id.tsx
Email and actions
- Dashboard and action queue
src/routes/index.tsx - Email match review
src/routes/index.tsx
Gmail integration
- Gmail sync screen
src/routes/gmail.tsx
API boundary
- API client
src/api/client.ts - Shared data contracts
src/contracts
Other components
- Career Companion user
- Career Companion backend
Connections 19
- Career Companion user → Frontend bootstrap: opens app
- Frontend bootstrap → Authentication helpers: checks session
- Frontend bootstrap → Root route: mounts router
- Frontend bootstrap → Theme provider: provides theme
- Root route → Login screen: routes to
- Root route → Dashboard and action queue: routes to
- Root route → Application list: routes to
- Root route → Application detail: routes to
- Root route → Gmail sync screen: routes to
- Dashboard and action queue → API client: loads data
- Email match review → API client: loads and resolves
- Application list → API client: lists and creates
- Application detail → API client: loads and updates
- Gmail sync screen → API client: uses Gmail API
- Authentication helpers → Career Companion backend: checks session
- Authentication helpers → API client: logs out
- API client → Career Companion backend: sends requests
- API client → Shared data contracts: uses types
- Application list → Shared data contracts: validates input