A full-stack web application for managing and tracking job application statuses. Monitor your job search progress with an intuitive dashboard, secure authentication, and comprehensive job tracking features.
- Overview
- Features
- Technology Stack
- Project Structure
- Quick Start
- Installation
- Running the Application
- API Documentation
- Project Architecture
- Development
- Deployment
- Contributing
- Troubleshooting
- License
Job Tracker is a comprehensive job application management system designed to help job seekers keep track of their applications, interview statuses, and overall job search progress. The application provides a modern, responsive interface with secure authentication and real-time job status updates.
Use Cases:
- Track job applications across multiple companies
- Monitor interview progress and timeline
- Maintain centralized job search notes and details
- Analyze job search statistics and patterns
- Manage multiple job opportunities simultaneously
- ✅ User Authentication - Secure signup/login with JWT tokens
- ✅ Job Application Tracking - Create, read, update, and delete job records
- ✅ Status Management - Track application states (Applied, Interview, Offer, Rejected)
- ✅ User Dashboard - Personalized dashboard with statistics and quick actions
- ✅ Responsive Design - Mobile-friendly interface for on-the-go tracking
- ✅ Real-time Updates - Instant application status changes
- ✅ Secure Data - Password encryption and JWT token-based authentication
- 📊 Application statistics and analytics
- 🔔 Status tracking timeline
- 📱 Mobile-optimized UI
- 🎨 Modern, intuitive interface
- ⚡ Fast and responsive performance
- Java 21 - Programming language
- Spring Boot 4.0.1 - Web framework
- Spring Data JPA - Database ORM
- Spring Security - Authentication & authorization
- JWT (io.jsonwebtoken) - Token-based authentication
- PostgreSQL - Relational database
- Maven - Build tool
- React 19 - UI library
- Vite 7.2.4 - Build tool & dev server
- Tailwind CSS 4.1.18 - Styling framework
- Material-UI (MUI) - Component library
- React Router 7.13.0 - Client-side routing
- React Icons 5.6.0 - Icon library
- DaisyUI 5.5.18 - UI component library
- Git - Version control
- Node.js 16+ - JavaScript runtime
- npm/yarn - Package managers
- ESLint - Code quality
- Maven Wrapper - Build automation
job-tracker/
├── backend/ # Spring Boot REST API
│ ├── src/
│ │ ├── main/
│ │ │ ├── java/
│ │ │ │ └── com/example/jobTracker/
│ │ │ │ ├── Controller/ # REST endpoints
│ │ │ │ ├── Service/ # Business logic
│ │ │ │ ├── Repository/ # Data access
│ │ │ │ ├── Entity/ # JPA entities
│ │ │ │ ├── dto/ # Data transfer objects
│ │ │ │ └── Security/ # Security config
│ │ │ └── resources/
│ │ │ └── application.properties # Config file
│ │ └── test/ # Unit tests
│ ├── pom.xml # Maven config
│ ├── mvnw & mvnw.cmd # Maven wrapper
│ └── README.md # Backend documentation
│
├── frontend/ # React Vite application
│ ├── src/
│ │ ├── main.jsx # Entry point
│ │ ├── App.jsx # Root component
│ │ ├── auth/ # Auth pages
│ │ ├── components/
│ │ │ ├── public/ # Public pages
│ │ │ ├── private/ # Protected components
│ │ │ └── User'/Dashboard/ # Dashboard views
│ │ ├── assets/ # Images, icons
│ │ └── reactbits/ # Reusable utilities
│ ├── index.html # HTML entry
│ ├── package.json # Dependencies
│ ├── vite.config.js # Vite config
│ └── README.md # Frontend documentation
│
├── .git/ # Version control
├── .github/ # GitHub workflows
├── .vscode/ # VS Code settings
└── README.md # This file
- Node.js 16+ and npm/yarn
- Java 21+ and Maven
- PostgreSQL 12+
- Git
-
Clone the repository:
git clone <repository-url> cd job-tracker
-
Setup Backend:
cd backend # Create PostgreSQL database createdb job_tracker # Update application.properties with your DB credentials # Then run: mvn spring-boot:run
-
Setup Frontend:
cd ../frontend npm install npm run dev -
Access the application:
- Frontend: http://localhost:5173
- Backend API: http://localhost:8080/api
See backend/README.md for detailed instructions.
Quick Install:
cd backend
# Configure PostgreSQL in src/main/resources/application.properties
mvn clean install
mvn spring-boot:runSee frontend/README.md for detailed instructions.
Quick Install:
cd frontend
npm install
npm run devTerminal 1 - Backend:
cd backend
mvn spring-boot:runTerminal 2 - Frontend:
cd frontend
npm run devBackend:
cd backend
mvn clean package -DskipTests
java -jar target/jobTracker-0.0.1-SNAPSHOT.jarFrontend:
cd frontend
npm run build
npm run previewhttp://localhost:8080/api
User Signup
POST /auth/signup
{
"username": "string",
"email": "string",
"password": "string"
}
User Login
POST /auth/login
{
"email": "string",
"password": "string"
}
Response:
{
"token": "jwt_token",
"username": "string"
}
Get All Jobs
GET /jobs
Authorization: Bearer <token>
Create Job
POST /jobs
Authorization: Bearer <token>
{
"company": "string",
"position": "string",
"status": "applied|interview|offer|rejected",
"dateApplied": "2026-04-23"
}
Update Job
PUT /jobs/{jobId}
Authorization: Bearer <token>
{
"status": "string"
}
Delete Job
DELETE /jobs/{jobId}
Authorization: Bearer <token>
Get Dashboard
GET /user/dashboard
Authorization: Bearer <token>
Update Profile
PUT /user/profile
Authorization: Bearer <token>
{
"username": "string",
"email": "string"
}
┌─────────────────────────────────────────────────────────────┐
│ Frontend (React + Vite) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Auth Pages │ │ Job Dashboard│ │ Landing │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ └──────────────────┴──────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│ HTTP/JSON
↓
┌─────────────────────────────────────────────────────────────┐
│ Backend API (Spring Boot + JWT Auth) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Auth │ │ Job │ │ User │ │
│ │ Controller │ │ Controller │ │ Controller │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ └──────────────────┴──────────────────┘ │
│ ┌────────────────────────────────────┐ │
│ │ Service Layer (Business Logic) │ │
│ └────────────────┬───────────────────┘ │
│ ┌────────────────▼───────────────────┐ │
│ │ Repository Layer (JPA) │ │
│ └────────────────┬───────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│ SQL
↓
┌─────────────────────────────────────────────────────────────┐
│ PostgreSQL Database │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ users table │ │ jobs table │ │ audit logs │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────────┘
- User Access → Frontend loads at http://localhost:5173
- Authentication → User logs in, receives JWT token
- Job Management → Frontend stores token, sends requests with auth header
- API Processing → Backend validates JWT, processes request
- Database → Spring Data JPA manages data persistence
- Response → Backend returns JSON response to frontend
- UI Update → React updates component state and renders
Backend:
- Controllers handle HTTP requests
- Services contain business logic
- Repositories manage database queries
- DTOs structure data for API responses
Frontend:
- Components are organized by feature
- React hooks manage component state
- Context API handles global state
- Tailwind/MUI provide styling
-
Create Feature Branch:
git checkout -b feature/your-feature
-
Make Changes:
- Backend: Update controllers/services
- Frontend: Update components
- Run tests and linting
-
Commit Changes:
git commit -am "Description of changes" -
Push and Create PR:
git push origin feature/your-feature
Backend:
cd backend
mvn testFrontend:
cd frontend
npm run lintBackend:
- Follow Java naming conventions
- Use meaningful variable names
- Write unit tests for services
- Document complex logic
Frontend:
- Use ESLint for code quality:
npm run lint - Follow React best practices
- Use descriptive component names
- Comment complex logic
-
Build JAR:
mvn clean package -DskipTests
-
Deploy to Server:
- Copy JAR to server
- Set environment variables
- Run:
java -jar jobTracker-0.0.1-SNAPSHOT.jar
Option 1: Netlify
npm run build
netlify deploy --prod --dir=distOption 2: Vercel
npm run build
vercel --prodOption 3: Traditional Hosting
- Build:
npm run build - Copy
dist/to web server - Configure server for SPA routing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -am 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Guidelines:
- Write clean, documented code
- Follow existing code style
- Include tests for new features
- Update documentation as needed
Backend won't start:
- Check PostgreSQL is running
- Verify database credentials in
application.properties - Ensure port 8080 is available
Frontend won't connect to backend:
- Verify backend is running on port 8080
- Check
VITE_API_URLin.envfile - Check CORS configuration in backend
Database connection errors:
- Create database:
createdb job_tracker - Check PostgreSQL credentials
- Verify database URL format
Port conflicts:
- Backend: Change
server.portinapplication.properties - Frontend: Use
npm run dev -- --port 3000
For detailed troubleshooting, see individual README files:
This project is provided as-is for educational and professional use.
For questions and issues:
-
Check Documentation:
-
Review Code:
- Check similar implementations
- Review git history for patterns
-
Debug:
- Check browser console for frontend errors
- Check server logs for backend errors
- Use network tab to inspect API calls
-
Contact:
- Create an issue in the repository
- Contact the development team
- Spring Boot Documentation
- Spring Security Documentation
- React Documentation
- Vite Documentation
- Tailwind CSS Documentation
- PostgreSQL Documentation
Project Status: Active Development
Last Updated: April 2026
Version: 0.0.1-SNAPSHOT
Ready to track your job search? Follow the Quick Start guide above to get up and running in minutes!
Questions? Check the individual README files in the backend and frontend folders for detailed documentation.