Skip to content

An AI assisted job read coach that helps a potential job seekers to land their job by providing career planner, github, linkedin profile reviewr, CV/Resume reviewer and many more functionality

License

Notifications You must be signed in to change notification settings

dan-kingo/PathWise-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

66 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PathWise AI

A comprehensive AI-powered career development platform that helps professionals advance their careers through personalized guidance, skill analysis, and intelligent recommendations.

๐Ÿš€ Overview

PathWise AI (formely Job-Ready-AI-Coach) is a full-stack web application that leverages artificial intelligence to provide personalized career coaching. The platform offers AI-driven career path generation, profile optimization, resume analysis, and skill gap identification to help users achieve their professional goals.

Landing Page

Landing Page

Dashboard

Dashboard

Career Path Planner Page

Career Path Planner

Profile Review Page

Profile Review Page

โœจ Features

๐ŸŽฏ AI Career Path Planner

  • Personalized Learning Roadmaps: Generate custom career paths based on your goals, current skills, and learning pace
  • Weekly Learning Plans: Structured week-by-week guidance with resources, milestones, and projects
  • Adaptive Pacing: Choose from slow, normal, or intensive learning speeds
  • Progress Tracking: Monitor your advancement through interactive dashboards

๐Ÿ” AI Profile Reviewer

  • LinkedIn Profile Analysis: Comprehensive AI review of LinkedIn profiles with actionable insights
  • GitHub Profile Optimization: Analyze GitHub profiles for developer visibility and impact
  • Industry Benchmarking: Compare your profile against industry standards
  • Improvement Recommendations: Prioritized suggestions for profile enhancement

๐Ÿ“„ AI Resume & CV Reviewer

  • Comprehensive Analysis: AI-powered resume analysis covering content, structure, and ATS compatibility
  • Skills Assessment: Identify skill gaps and get recommendations for improvement
  • Industry-Specific Insights: Tailored feedback based on target roles and industries
  • ATS Optimization: Ensure your resume passes Applicant Tracking Systems

๐Ÿ‘ค Profile Management

  • Complete Profile Setup: Guided profile creation with education, experience, and career goals
  • Skill Tracking: Manage and showcase your technical and soft skills
  • Learning Progress: Track completed resources, milestones, and achievements
  • Goal Setting: Define and monitor career objectives

๐Ÿ” Authentication & Security

  • Multiple Login Options: Email/password and Google OAuth integration
  • Email Verification: Secure account verification process
  • Password Management: Forgot password and change password functionality
  • Session Management: Secure JWT-based authentication

๐Ÿ“Š Analytics & Insights

  • Progress Analytics: Visualize your learning journey and improvements
  • Performance Metrics: Track scores, completion rates, and trends
  • Personalized Insights: AI-generated recommendations based on your activity

๐Ÿ› ๏ธ Technology Stack

Frontend

  • React 18 with TypeScript
  • Tailwind CSS for styling
  • React Router for navigation
  • React Hook Form with Zod validation
  • Zustand for state management
  • Vite for build tooling

Backend

  • Node.js with Express.js
  • TypeScript for type safety
  • MongoDB with Mongoose ODM
  • JWT for authentication
  • Passport.js for OAuth
  • Multer & Cloudinary for file uploads

AI Integration

  • Grok AI (xAI) for intelligent analysis and recommendations
  • GitHub Models API for AI-powered insights
  • Custom AI prompts for career guidance and profile optimization

Additional Services

  • Nodemailer for email services
  • bcryptjs for password hashing
  • Helmet for security headers
  • Rate limiting for API protection

๐Ÿ“ Project Structure

Job-Ready-AI-Coach/
โ”œโ”€โ”€ backend/                          # Node.js backend application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ configs/                  # Configuration files
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ cloudinary.ts         # Cloudinary setup
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ db.ts                 # Database connection
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ passport.ts           # Passport OAuth config
โ”‚   โ”‚   โ”œโ”€โ”€ controllers/              # Route controllers
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth.controller.ts    # Authentication logic
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ career.controller.ts  # Career planning logic
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profile.controller.ts # Profile management
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profileReviewer.controller.ts
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ resumeReviewer.controller.ts
โ”‚   โ”‚   โ”œโ”€โ”€ middlewares/              # Express middlewares
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth.middleware.ts    # JWT authentication
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ error.middleware.ts   # Error handling
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ validation.middleware.ts
โ”‚   โ”‚   โ”œโ”€โ”€ models/                   # MongoDB schemas
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ user.model.ts         # User schema
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profile.model.ts      # Profile schema
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ career.model.ts       # Career path schema
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profileReview.model.ts
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ resumeReview.model.ts
โ”‚   โ”‚   โ”œโ”€โ”€ routes/                   # API routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth.route.ts         # Authentication routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ career.route.ts       # Career planning routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profile.route.ts      # Profile routes
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profileReviewer.route.ts
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ resumeReviewer.route.ts
โ”‚   โ”‚   โ”œโ”€โ”€ services/                 # Business logic services
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ email.service.ts      # Email functionality
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ grok.service.ts       # AI integration
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ resumeParser.service.ts
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ resumeAnalyzer.service.ts
โ”‚   โ”‚   โ”œโ”€โ”€ utils/                    # Utility functions
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth.utils.ts         # Auth helpers
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ validation.utils.ts   # Validation helpers
โ”‚   โ”‚   โ””โ”€โ”€ server.ts                 # Express server setup
โ”‚   โ”œโ”€โ”€ package.json                  # Backend dependencies
โ”‚   โ”œโ”€โ”€ tsconfig.json                 # TypeScript config
โ”‚   โ””โ”€โ”€ .env.example                  # Environment variables template
โ”œโ”€โ”€ frontend/                         # React frontend application
โ”‚   โ”œโ”€โ”€ public/
โ”‚   โ”‚   โ””โ”€โ”€ favicon.svg               # App favicon
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/               # React components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ui/                   # Reusable UI components
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Button.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Input.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Select.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Textarea.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ Toast.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ career/               # Career-related components
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ AICareerPathPlanner.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ WeeklyLearningPlan.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ SkillGapAnalysis.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ dashboard/            # Dashboard components
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Navbar.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ WelcomeHeader.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ QuickActions.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ QuickStats.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profile/              # Profile components
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ProfileSetup.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ProfileReviewer.tsx
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ LinkedInDataForm.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ resume/               # Resume components
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ resumeReviewer.tsx
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard.tsx         # Main dashboard
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ LandingPage.tsx       # Landing page
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ LoginPage.tsx         # Authentication
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ LoadingSpinner.tsx    # Loading component
โ”‚   โ”‚   โ”œโ”€โ”€ stores/                   # Zustand state stores
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ authStore.ts          # Authentication state
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ profileStore.ts       # Profile state
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ careerStore.ts        # Career state
โ”‚   โ”‚   โ”œโ”€โ”€ services/                 # API services
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ api.ts                # API client
โ”‚   โ”‚   โ”œโ”€โ”€ schemas/                  # Validation schemas
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ profileSchema.ts      # Zod schemas
โ”‚   โ”‚   โ”œโ”€โ”€ types/                    # TypeScript types
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth.ts               # Auth types
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ dashboard.ts          # Dashboard types
โ”‚   โ”‚   โ”œโ”€โ”€ utils/                    # Utility functions
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ cn.ts                 # Class name utility
โ”‚   โ”‚   โ”œโ”€โ”€ App.tsx                   # Main App component
โ”‚   โ”‚   โ”œโ”€โ”€ main.tsx                  # React entry point
โ”‚   โ”‚   โ””โ”€โ”€ index.css                 # Global styles
โ”‚   โ”œโ”€โ”€ package.json                  # Frontend dependencies
โ”‚   โ”œโ”€โ”€ tailwind.config.js            # Tailwind configuration
โ”‚   โ”œโ”€โ”€ tsconfig.json                 # TypeScript config
โ”‚   โ””โ”€โ”€ vite.config.ts                # Vite configuration
โ”œโ”€โ”€ Job-Ready-AI-Coach.postman_collection.json  # API documentation
โ”œโ”€โ”€ LICENSE                           # MIT License
โ”œโ”€โ”€ README.md                         # Project documentation
โ””โ”€โ”€ package.json                      # Root package.json

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • MongoDB (local or cloud instance)
  • Grok AI API key (from xAI)
  • Cloudinary account (for file uploads)
  • Google OAuth credentials (optional)

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/Job-Ready-AI-Coach.git
    cd Job-Ready-AI-Coach
  2. Install dependencies

    # Install backend dependencies
    cd backend
    npm install
    
    # Install frontend dependencies
    cd ../frontend
    npm install
  3. Environment Setup

    Backend (backend/.env):

    # Database
    MONGO_URI_LOCAL=mongodb://localhost:27017/job-ready-ai-coach
    
    # JWT
    JWT_SECRET=your-super-secret-jwt-key-here
    
    # Session
    SESSION_SECRET=your-session-secret-here
    
    # Google OAuth (optional)
    GOOGLE_CLIENT_ID=your-google-client-id
    GOOGLE_CLIENT_SECRET=your-google-client-secret
    
    # Email Configuration
    EMAIL_USER=your-email@gmail.com
    EMAIL_PASSWORD=your-app-password
    EMAIL_FROM=noreply@jobreadyai.com
    
    # Frontend URL
    FRONTEND_URL=http://localhost:5173
    
    # Server
    PORT=3000
    
    # Grok AI Configuration
    GITHUB_TOKEN=your-github-token-for-models-api

    Frontend (frontend/.env):

    VITE_API_URL=http://localhost:3000
  4. Start the development servers

    Backend:

    cd backend
    npm run dev

    Frontend (in a new terminal):

    cd frontend
    npm run dev
  5. Access the application

๐Ÿ“– API Documentation

The project includes a comprehensive Postman collection (Job-Ready-AI-Coach.postman_collection.json) with all API endpoints documented. Import this collection into Postman to explore the API.

Key API Endpoints

  • Authentication: /auth/* - Login, signup, OAuth, password management
  • Profile: /profile/* - User profile management
  • Career: /career/* - AI career path generation and management
  • Profile Reviewer: /profile-reviewer/* - LinkedIn/GitHub profile analysis
  • Resume Reviewer: /resume-reviewer/* - Resume analysis and feedback

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“„ License

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

๐Ÿ™ Acknowledgments

๐Ÿ“ž Support

For support, email hello@jobreadyai.com or create an issue in this repository.

๐Ÿ”ฎ Roadmap

  • Mobile application (React Native)
  • Advanced AI coaching conversations
  • Integration with job boards
  • Salary negotiation guidance
  • Interview preparation tools
  • Team collaboration features
  • Advanced analytics dashboard

Built with โค๏ธ by the Job Ready AI Coach team

About

An AI assisted job read coach that helps a potential job seekers to land their job by providing career planner, github, linkedin profile reviewr, CV/Resume reviewer and many more functionality

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages