An intelligent job application tracking system that automatically parses your Gmail to extract and organize job application emails, providing analytics and export capabilities.
β οΈ Note: This app is currently in the testing phase and limited to 100 users due to Gmail API quota restrictions.
- Smart Gmail Integration: Connects to your Gmail account via OAuth2 authentication
- Intelligent Email Parsing: Automatically detects job application emails using advanced pattern matching
- Company & Role Extraction: Uses regex patterns to extract company names and job roles from email content
- Status Classification: Automatically categorizes applications as Applied, Interview, Rejected, Offer, etc.
- Bulk Email Filtering: Filters out job board spam and promotional emails
- Application Statistics: Track success rates, response rates, and application trends
- Status Distribution: Visual breakdown of application statuses
- Timeline Analytics: Monitor application activity over time
- Performance Metrics: Calculate interview and offer conversion rates
- Multi-criteria Search: Filter by company, role, email, or status
- Date Range Filtering: Focus on specific time periods
- Real-time Results: Instant filtering with no page reloads
- Excel Spreadsheets: Export data as professional .xlsx files
- CSV Export: Simple comma-separated format for external tools
- Analytics Reports: Comprehensive reports with summary statistics
- Google Sheets Compatible: Formatted for easy import into Google Sheets
- Next.js 15 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- shadcn/ui - Modern React component library
- Lucide React - Beautiful icons
- Next.js API Routes - Serverless backend functions
- Google APIs - Gmail and OAuth2 integration
- googleapis - Official Google API client
- ExcelJS - Excel file generation
- Zustand - Lightweight state management
- date-fns - Date manipulation utilities
- Vercel - Zero-config deployment platform
- Environment Variables - Secure credential management
- Node.js 18+ and npm
- Google Cloud Console account
- Gmail account for testing
git clone https://github.com/yourusername/job-app-tracker-gmail.git
cd job-app-tracker-gmail
npm install- Create a project in Google Cloud Console
- Enable Gmail API and Google+ API
- Create OAuth2 credentials
- Add authorized redirect URI:
http://localhost:3000/api/auth/callback/route
Create .env.local:
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/api/auth/callback/googlenpm run devVisit http://localhost:3000
- OAuth Authentication: Secure Gmail access via Google OAuth2
- Smart Querying: Searches emails using job-related keywords
- Content Analysis: Extracts company names, job titles, and application status
- Data Normalization: Cleans and structures extracted information
- Duplicate Prevention: Avoids processing the same email multiple times
The system uses sophisticated regex patterns to identify:
- Job Applications: "thank you for applying", "application received"
- Interview Invitations: "next steps", "would like to invite you"
- Rejections: "not selected", "pursue other candidates"
- Company Names: Extracts from email signatures and content
- Job Titles: Identifies roles from subject lines and body text
- Job Seekers: Track all applications automatically without manual entry
- Career Coaches: Help clients organize their job search process
- Recruiters: Monitor candidate application patterns
- Students: Manage internship and entry-level job applications
- OAuth2 Authentication: Industry-standard secure authentication
- Read-Only Access: Only reads emails, never modifies or sends
- Local Processing: Email content processed client-side when possible
- No Data Storage: Emails are not stored on external servers
- Secure Cookies: HTTP-only cookies for token management
- Fork this repository
- Connect your GitHub to Vercel
- Set environment variables in Vercel dashboard
- Update Google Cloud Console with production redirect URI
- Deploy automatically
npm run build
npm start- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- shadcn/ui for the beautiful component library
- Google APIs for Gmail integration
- Vercel for seamless deployment
- Next.js team for the amazing framework
If you encounter any issues or have questions:
- Open an issue on GitHub
- Email Me directly
β Star this repository if it helped you track your job applications more effectively!