{"id":31986676,"url":"https://github.com/tomiwajin/careersync","last_synced_at":"2026-04-29T16:03:53.808Z","repository":{"id":307569759,"uuid":"1023959130","full_name":"Tomiwajin/CareerSync","owner":"Tomiwajin","description":"🔒 AI-powered job application tracker with Gmail integration. Automatically organize applications, track responses, and visualize your job search — completely stateless with zero data storage. 100% free and open source.","archived":false,"fork":false,"pushed_at":"2026-03-30T03:59:50.000Z","size":871,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-30T04:38:56.941Z","etag":null,"topics":["google-api","job-tracker","next-js","open-source","postgresql","typescript"],"latest_commit_sha":null,"homepage":"http://careersync.cloud","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tomiwajin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-22T01:23:22.000Z","updated_at":"2026-03-30T03:59:54.000Z","dependencies_parsed_at":"2025-08-01T00:45:39.379Z","dependency_job_id":"e47344a5-bd69-4243-9dc7-bb2a66a1da89","html_url":"https://github.com/Tomiwajin/CareerSync","commit_stats":null,"previous_names":["tomiwajin/job-app-tracker-gmail","tomiwajin/gmail-job-tracking-tool","tomiwajin/careersync"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Tomiwajin/CareerSync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tomiwajin%2FCareerSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tomiwajin%2FCareerSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tomiwajin%2FCareerSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tomiwajin%2FCareerSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tomiwajin","download_url":"https://codeload.github.com/Tomiwajin/CareerSync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tomiwajin%2FCareerSync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32432917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-api","job-tracker","next-js","open-source","postgresql","typescript"],"created_at":"2025-10-15T07:42:34.225Z","updated_at":"2026-04-29T16:03:53.803Z","avatar_url":"https://github.com/Tomiwajin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📧 Job Application Tracker - Gmail Integration\n\nAn intelligent job application tracking system that automatically parses your Gmail to extract and organize job application emails, providing analytics and export capabilities.\n\n## 🚀 Live Demo\n\n[**View Live App**](https://job-app-tracker-gmail.vercel.app)\n\n## ⚠️ Note: This app is currently in the testing phase and limited to 100 users due to Gmail API quota restrictions.\n\n## ✨ Features\n\n### 🤖 Automatic Email Processing\n- **Smart Gmail Integration**: Connects to your Gmail account via OAuth2 authentication\n- **Intelligent Email Parsing**: Automatically detects job application emails using advanced pattern matching\n- **Company \u0026 Role Extraction**: Uses regex patterns to extract company names and job roles from email content\n- **Status Classification**: Automatically categorizes applications as Applied, Interview, Rejected, Offer, etc.\n- **Bulk Email Filtering**: Filters out job board spam and promotional emails\n\n### 📊 Analytics Dashboard\n- **Application Statistics**: Track success rates, response rates, and application trends\n- **Status Distribution**: Visual breakdown of application statuses\n- **Timeline Analytics**: Monitor application activity over time\n- **Performance Metrics**: Calculate interview and offer conversion rates\n\n### 🔍 Advanced Filtering \u0026 Search\n- **Multi-criteria Search**: Filter by company, role, email, or status\n- **Date Range Filtering**: Focus on specific time periods\n- **Real-time Results**: Instant filtering with no page reloads\n\n### 📤 Export Capabilities\n- **Excel Spreadsheets**: Export data as professional .xlsx files\n- **CSV Export**: Simple comma-separated format for external tools\n- **Analytics Reports**: Comprehensive reports with summary statistics\n- **Google Sheets Compatible**: Formatted for easy import into Google Sheets\n\n## 🛠️ Tech Stack\n\n### Frontend\n- **Next.js 15** - React framework with App Router\n- **TypeScript** - Type-safe development\n- **Tailwind CSS** - Utility-first styling\n- **shadcn/ui** - Modern React component library\n- **Lucide React** - Beautiful icons\n\n### Backend\n- **Next.js API Routes** - Serverless backend functions\n- **Google APIs** - Gmail and OAuth2 integration\n- **googleapis** - Official Google API client\n\n### Data \u0026 Export\n- **ExcelJS** - Excel file generation\n- **Zustand** - Lightweight state management\n- **date-fns** - Date manipulation utilities\n\n### Deployment\n- **Vercel** - Zero-config deployment platform\n- **Environment Variables** - Secure credential management\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Node.js 18+ and npm\n- Google Cloud Console account\n- Gmail account for testing\n\n### 1. Clone Repository\n```bash\ngit clone https://github.com/yourusername/job-app-tracker-gmail.git\ncd job-app-tracker-gmail\nnpm install\n```\n\n### 2. Google Cloud Setup\n1. Create a project in [Google Cloud Console](https://console.cloud.google.com/)\n2. Enable Gmail API and Google+ API\n3. Create OAuth2 credentials\n4. Add authorized redirect URI: `http://localhost:3000/api/auth/callback/route`\n\n### 3. Environment Variables\nCreate `.env.local`:\n```env\nGOOGLE_CLIENT_ID=your_google_client_id\nGOOGLE_CLIENT_SECRET=your_google_client_secret\nGOOGLE_REDIRECT_URI=http://localhost:3000/api/auth/callback/google\n```\n\n### 4. Run Development Server\n```bash\nnpm run dev\n```\nVisit `http://localhost:3000`\n\n## 📋 How It Works\n\n### Email Processing Flow\n1. **OAuth Authentication**: Secure Gmail access via Google OAuth2\n2. **Smart Querying**: Searches emails using job-related keywords\n3. **Content Analysis**: Extracts company names, job titles, and application status\n4. **Data Normalization**: Cleans and structures extracted information\n5. **Duplicate Prevention**: Avoids processing the same email multiple times\n\n### Pattern Recognition\nThe system uses sophisticated regex patterns to identify:\n- **Job Applications**: \"thank you for applying\", \"application received\"\n- **Interview Invitations**: \"next steps\", \"would like to invite you\"\n- **Rejections**: \"not selected\", \"pursue other candidates\"\n- **Company Names**: Extracts from email signatures and content\n- **Job Titles**: Identifies roles from subject lines and body text\n\n## 🎯 Use Cases\n\n- **Job Seekers**: Track all applications automatically without manual entry\n- **Career Coaches**: Help clients organize their job search process\n- **Recruiters**: Monitor candidate application patterns\n- **Students**: Manage internship and entry-level job applications\n\n## 🔒 Privacy \u0026 Security\n\n- **OAuth2 Authentication**: Industry-standard secure authentication\n- **Read-Only Access**: Only reads emails, never modifies or sends\n- **Local Processing**: Email content processed client-side when possible\n- **No Data Storage**: Emails are not stored on external servers\n- **Secure Cookies**: HTTP-only cookies for token management\n\n## 🚀 Deployment\n\n### Vercel (Recommended)\n1. Fork this repository\n2. Connect your GitHub to Vercel\n3. Set environment variables in Vercel dashboard\n4. Update Google Cloud Console with production redirect URI\n5. Deploy automatically\n\n### Manual Deployment\n```bash\nnpm run build\nnpm start\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [shadcn/ui](https://ui.shadcn.com/) for the beautiful component library\n- [Google APIs](https://developers.google.com/gmail/api) for Gmail integration\n- [Vercel](https://vercel.com) for seamless deployment\n- [Next.js](https://nextjs.org) team for the amazing framework\n\n## 📞 Support\n\nIf you encounter any issues or have questions:\n- Open an issue on GitHub\n- [Email Me](oluwatomiwajinadu@gmail.com) directly\n\n---\n\n⭐ **Star this repository if it helped you track your job applications more effectively!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomiwajin%2Fcareersync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomiwajin%2Fcareersync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomiwajin%2Fcareersync/lists"}