Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

20 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Job Search Companion

A comprehensive AI-powered job application tracking and career management platform built with Next.js, TypeScript, Supabase, and Google Gemini AI.

Note: This application supports both cloud (Supabase) and local (SQLite) storage modes for flexibility and offline usage.

Features

🎯 Core Functionality

  • Job Application Tracking: Manage applications with status tracking, notes, and filters
  • Skill Development: Visualize skill gaps with radar charts and AI recommendations
  • Smart To-Do Management: Context-aware tasks with priority levels and due dates
  • AI Career Assistant: Chat interface powered by Google Gemini for personalized advice
  • Email Integration: Import and parse job application emails from Gmail
  • Local Storage Mode: SQLite-based local database for offline usage

🤖 AI Capabilities

  • Resume enhancement and optimization
  • Cover letter writing assistance
  • Interview preparation and practice questions
  • Job description analysis
  • Skill gap identification and parsing from resumes
  • Networking message templates
  • Salary negotiation guidance

📊 Analytics & Visualization

  • Application status dashboard with charts
  • Skill progression tracking
  • Weekly activity monitoring
  • Response rate analytics

Tech Stack

Frontend

  • Next.js 15 with App Router
  • React 18 with TypeScript
  • Tailwind CSS for styling
  • shadcn/ui component library
  • Recharts for data visualization
  • Lucide React for icons

Backend

  • Next.js API Routes for serverless functions
  • Supabase for database and authentication (cloud mode)
  • SQLite / better-sqlite3 for local storage mode
  • PostgreSQL (via Supabase)

AI Integration

  • Google Gemini API for natural language processing
  • gemini-2.5-flash model for fast and accurate responses
  • Context-aware responses
  • Personalized career advice

Getting Started

Prerequisites

  • Node.js 18+ and npm/pnpm
  • Supabase project (for cloud mode)
  • Google Gemini API key
  • Gmail API credentials (for email import feature)

Installation

  1. Clone the repository
git clone <repository-url>
cd ai-job-assistant
  1. Install dependencies
npm install
# or
pnpm install
  1. Set up environment variables Create a .env.local file in the root directory:
# AI Integration
GEMINI_API_KEY="your-google-gemini-api-key"

# Supabase Configuration (cloud mode)
NEXT_PUBLIC_SUPABASE_URL="your-supabase-project-url"
NEXT_PUBLIC_SUPABASE_ANON_KEY="your-supabase-anon-key"

# Gmail API (email import feature)
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"
GOOGLE_REDIRECT_URI="http://localhost:3000/api/email/callback"

# Local Mode (optional - uses local.db SQLite file)
# No additional env vars needed
  1. Run the development server
npm run dev
# or
pnpm dev

Open http://localhost:3000 to see the application.

Project Structure

ai-job-search-companion/
├── app/                          # Next.js App Router
│   ├── api/                      # API routes
│   │   ├── applications/         # Job applications CRUD
│   │   ├── skills/              # Skills management
│   │   ├── tasks/               # Task management
│   │   ├── ai/                  # AI chat integration
│   │   ├── email/               # Email import & parsing
│   │   └── local/               # Local storage mode APIs
│   ├── dashboard/               # Main application pages
│   │   ├── applications/        # Applications management
│   │   ├── skills/             # Skill visualization
│   │   ├── todos/              # Task management
│   │   ├── ai-assistant/       # AI chat interface
│   │   └── email-import/       # Gmail import page
│   ├── layout.tsx              # Root layout
│   └── page.tsx                # Landing/login page
├── components/                  # Reusable components
│   ├── ui/                     # shadcn/ui components
│   ├── app-sidebar.tsx         # Navigation sidebar
│   ├── login-form.tsx          # Authentication form
│   ├── drag-drop-tasks.tsx     # Draggable task list
│   └── auth-provider.tsx       # Authentication context
├── lib/                        # Utility libraries
│   ├── types.ts               # TypeScript interfaces & type guards
│   ├── auth.ts                # Authentication utilities
│   ├── gemini.ts              # AI integration (Google Gemini)
│   ├── email-parser.ts        # Email parsing utilities
│   ├── local-db.ts            # SQLite local database layer
│   ├── supabase.ts            # Supabase client
│   └── utils.ts               # General utility functions
├── tests/                      # Test files (*test.ts)
├── local.db                    # SQLite database (local mode)
├── supabase-schema.sql         # Database schema for Supabase
└── package.json                # Dependencies & scripts

Key Features Explained

1. Dashboard Overview

  • Real-time application statistics
  • Visual charts for status tracking
  • Quick AI assistant access
  • Upcoming task reminders

2. Application Management

  • Full CRUD operations for job applications
  • Status filtering and search functionality
  • Notes and timeline tracking
  • Export capabilities

3. Skill Development

  • Interactive radar charts comparing current vs target skills
  • AI-powered skill recommendations
  • AI Skill Parsing: Automatically extract skills from resume text
  • Learning resource suggestions
  • Progress tracking over time

4. Smart Task Management

  • Context-aware task creation
  • Priority-based organization
  • Due date tracking and reminders
  • AI-suggested tasks based on applications
  • Drag-and-drop reordering

5. AI Assistant Integration

  • Natural language processing with Google Gemini
  • Context-aware responses
  • Prompt suggestions for common scenarios
  • Conversation history and analytics

6. Email Import (NEW)

  • Connect Gmail account via OAuth
  • Automatically parse job application emails
  • Extract company names, positions, and dates
  • Bulk import applications into tracker

7. Local Storage Mode (NEW)

  • SQLite-based local database (local.db)
  • Works offline without Supabase
  • Seamless fallback when cloud credentials unavailable
  • Same API interface as cloud mode

API Endpoints

Authentication

  • POST /api/auth/login - User login
  • POST /api/auth/register - User registration
  • POST /api/auth/logout - User logout

Applications

  • GET /api/applications - Fetch user applications
  • POST /api/applications - Create new application
  • PUT /api/applications - Update application
  • DELETE /api/applications - Delete application

Skills

  • GET /api/skills - Fetch user skills
  • POST /api/skills - Add new skill
  • PUT /api/skills - Update skill proficiency
  • POST /api/local/skills/parse - AI-powered skill extraction from text

Tasks

  • GET /api/tasks - Fetch user tasks
  • POST /api/tasks - Create new task
  • PUT /api/tasks - Update task status
  • GET /api/local/tasks - Local mode task operations

AI Integration

  • POST /api/ai/chat - Send message to AI assistant
  • GET /api/ai/suggestions - Get AI-powered suggestions

Email Import

  • GET /api/email - Initiate Gmail OAuth flow
  • GET /api/email/callback - OAuth callback handler
  • GET /api/email/applications - Fetch parsed application emails

Database Schema

Cloud Mode (Supabase/PostgreSQL)

The application uses a Supabase (PostgreSQL) database. See supabase-schema.sql for the full schema. Main tables include:

  • applications - Job application tracking
  • skills - User skills and proficiency levels
  • tasks - To-do items with context and priorities
  • notifications - System notifications

Local Mode (SQLite)

  • Uses local.db file in the project root
  • Same data model as cloud mode
  • Automatically created on first run
  • No authentication required

Security Features

  • Supabase Auth for user management
  • Row Level Security (RLS) policies
  • Environment variable protection
  • Rate limiting on API endpoints
  • OAuth 2.0 for Gmail integration
  • JWT token validation for API requests

Testing

Run tests with:

npm test
# or
pnpm test

Test Coverage

  • Authentication (lib/auth.test.ts) - Login, token validation, user management
  • Components (components/*test.tsx) - UI component rendering and interactions
  • Types (lib/types.test.ts) - Type guards and validation functions
  • Utils (lib/utils.test.ts) - Utility function testing
  • Local DB (lib/local-db.test.ts) - SQLite database operations

Performance Optimizations

  • Server-side rendering with Next.js
  • Image optimization
  • Code splitting and lazy loading
  • Database indexing
  • Caching strategies
  • Optimized bundle size

Deployment

Vercel (Recommended)

  1. Connect your GitHub repository to Vercel
  2. Set environment variables in Vercel dashboard
  3. Deploy automatically on push to main branch

Manual Deployment

  1. Build the application: npm run build
  2. Set up production database
  3. Configure environment variables
  4. Deploy to your hosting platform

Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/new-feature
  3. Commit changes: git commit -am 'Add new feature'
  4. Push to branch: git push origin feature/new-feature
  5. Submit a pull request

License

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

Support

For support and questions:

  • Create an issue on GitHub
  • Check the documentation
  • Review the FAQ section

Roadmap

Upcoming Features

  • Mobile app development
  • Advanced analytics dashboard
  • Integration with job boards (LinkedIn, Indeed)
  • Team collaboration features
  • Advanced AI coaching
  • Resume parsing and optimization
  • Interview scheduling integration
  • Salary benchmarking tools
  • AI-powered job recommendations

Version History

  • v1.0.0 - Initial release with core features
  • v1.1.0 - Enhanced AI capabilities
  • v1.2.0 - Mobile responsiveness improvements
  • v2.0.0 - Advanced analytics and reporting
  • v2.1.0 - Email integration and local storage mode
  • v2.1.1 - Comprehensive test coverage

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages