🚀 NextMove

A modern full-stack job application tracking system

Transform your job search with intelligent tracking and analytics ✨

---

📋 What is NextMove?

NextMove is a comprehensive job application tracking system designed to streamline your job search process. Built with modern technologies, it provides:

• 📊 Smart Analytics - Visualize your job search progress
• 🏢 Company Management - Track companies and contacts
• 📅 Interview Scheduling - Never miss an important interview
• 🔐 Secure Authentication - JWT-based security
• 📱 Responsive Design - Works on all devices

🏗️ System Architecture

graph TB
    subgraph "Frontend Layer"
        A[React 19 + TypeScript]
        B[Tailwind CSS]
        C[Vite Build Tool]
    end
    
    subgraph "Backend Layer"
        D[Spring Boot 3.5]
        E[JWT Authentication]
        F[REST API]
    end
    
    subgraph "Data Layer"
        G[PostgreSQL 15+]
        H[JPA/Hibernate]
    end
    
    subgraph "Infrastructure"
        I[Docker Containers]
        J[Docker Compose]
    end
    
    A --> D
    D --> G
    D --> H
    E --> F
    I --> A
    I --> D
    I --> G

Loading

📊 Technology Stack

Layer	Technology	Purpose	Version
🎨 Frontend	React + TypeScript	User Interface	19.0
⚡ Build Tool	Vite	Fast Development	Latest
🎯 Styling	Tailwind CSS	Modern UI	Latest
🚀 Backend	Spring Boot	API & Business Logic	3.5.0
🗄️ Database	PostgreSQL	Data Persistence	15+
🔒 Auth	JWT + Spring Security	Authentication	Latest
🐳 Container	Docker	Deployment	Latest

🚀 Quick Start

🐳 With Docker (Recommended)

# 1️⃣ Clone the repository
git clone https://github.com/jnleyva816/NextMove.git
cd NextMove

# 2️⃣ Start all services
docker-compose up -d

# 3️⃣ Access the application
# 🌐 Frontend: http://localhost:3000
# 🔌 Backend API: http://localhost:8080
# 🗄️ Database: localhost:5432

🛠️ Manual Development Setup

Prerequisites: Java 17+, Node.js 20+, PostgreSQL 15+

# Backend setup
cd backend
cp .env.example .env  # Configure your environment
./mvnw spring-boot:run

# Frontend setup (new terminal)
cd frontend
npm install
npm run dev

📈 Project Progress

gantt
    title NextMove Development Timeline
    dateFormat  YYYY-MM-DD
    section Backend 🚀
    API Development     :done,    api, 2024-01-01, 2024-02-15
    Database Schema     :done,    db, 2024-01-01, 2024-01-30
    Authentication      :done,    auth, 2024-01-15, 2024-02-01
    Testing Framework   :done,    test, 2024-02-01, 2024-02-15
    
    section Frontend 🎨
    Project Setup       :done,    setup, 2024-02-01, 2024-02-05
    UI Components       :active,  ui, 2024-02-05, 2024-03-01
    Integration         :         int, 2024-02-15, 2024-03-15
    
    section DevOps 🔧
    Containerization    :done,    docker, 2024-01-01, 2024-01-15
    CI/CD Pipeline      :done,    cicd, 2024-01-15, 2024-02-01

Loading

🌟 Key Features

Feature	Description	Status
🔐 Authentication	JWT-based secure login	✅
📊 Job Tracking	Track applications & status	✅
🏢 Company Management	Manage companies & contacts	✅
📅 Interview Scheduling	Schedule & track interviews	✅
📈 Analytics Dashboard	Visual progress tracking	🚧
📱 Mobile Responsive	Works on all devices	🚧

🤝 How to Contribute

We welcome contributions! Here's how you can help:

🎯 Quick Contribution Steps

# 1️⃣ Fork & clone
git clone https://github.com/YOUR_USERNAME/NextMove.git

# 2️⃣ Create feature branch
git checkout -b feature/amazing-feature

# 3️⃣ Make changes & test
npm test  # Frontend tests
./mvnw test  # Backend tests

# 4️⃣ Commit & push
git commit -m "✨ Add amazing feature"
git push origin feature/amazing-feature

# 5️⃣ Create Pull Request

📚 Detailed Guidelines

For comprehensive contribution information, check out:

• 📖 Contributing Guide - Detailed contribution process
• 📋 Code of Conduct - Community guidelines
• 🐛 Issue Templates - Report bugs or request features

🎨 Areas We Need Help

• 🎨 Frontend Development - React components & UI/UX
• 📊 Data Visualization - Charts and analytics
• 🧪 Testing - Unit, integration, and E2E tests
• 📝 Documentation - API docs, tutorials, guides
• 🔒 Security - Security audits and improvements

📚 Documentation & Resources

Resource	Description	Link
📖 Wiki	Comprehensive documentation	WIKI/
🚀 Quick Setup	Rapid development guide	QUICK-SETUP.md
🎯 Backend Docs	Spring Boot API documentation	backend/README.md
🎨 Frontend Docs	React application guide	frontend/README.md
🐳 Deployment	Production deployment guides	deployment/

🛠️ Development Tools

Backend Stack

Spring Boot • PostgreSQL • JWT • JUnit • Maven

Frontend Stack

React 19 • TypeScript • Vite • Tailwind • Vitest

DevOps Stack

Docker • Docker Compose • GitHub Actions

📞 Support & Community

• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Contact: Create an issue for any questions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ for the developer community

⭐ Star us on GitHub if this project helped you!