VibeHired is an AI-powered job application assistant that transforms your job search into an efficient, intelligent workflow. Powered by Google Gemini AI, the platform generates tailored CVs and cover letters for every role, tracks all your applications, interviews, and deadlines in one place, scores ATS compatibility, and provides real-time assistance—so nothing slips through the cracks.
Try the live application: https://vibehired.ganainy.dev
For detailed per-feature documentation see FEATURES.md.
| Feature | Summary |
|---|---|
| User Authentication | JWT login, Google OAuth, email verification, password reset, disposable email blocking |
| Job Application Management | AI job extraction from URLs, dashboard view, status tracking, follow-up eligibility nudges |
| CV Management | Multi-branch CV system, AI parsing to freeform + tags, dynamic editor, AI analysis |
| AI-Powered Features | Tailored CV & cover letter generation, ATS scoring, chat assistant, draft generation |
| Gmail Email Automation | On-demand inbox scanning, batch AI classification, suggest-then-confirm flow |
| Analytics Dashboard | Key metrics, visual charts, weekly goal tracker, pipeline conversion |
| Portfolio System | GitHub/LinkedIn import, public portfolio page, project management |
| Settings & Configuration | Profile management, credit balance & usage stats, subscription plans |
| Admin Dashboard | AI call tracking, system statistics, user management (admin only) |
| Review & Finalization | AI draft review, tailoring change log (before/after), inline diff preview, PDF generation |
| Interview Prep Library | Per-job materials, bulk upload, inline preview, global library, favourites |
| Work Tracker | Session logging with type filters, reminders, Google Calendar integration |
| Mock Interview | AI-powered practice with first and second round prompt options |
| Google Calendar | Interview scheduling and calendar event management |
| AI Interview Buddy | Electron companion app — currently in development, available to admins only |
- Frontend: React, TypeScript, Vite, Tailwind CSS, React Router, Axios
- Backend: Node.js, Express, TypeScript, MongoDB, Mongoose
- Authentication: JWT (jsonwebtoken), bcryptjs
- File Handling: Multer
- Image Hosting: Cloudinary
- AI: Google Generative AI SDK (
@google/generative-ai), Web Speech API - Web Scraping: Apify (for LinkedIn profile scraping)
- PDF Generation: Puppeteer
- CV Schema: JSON Resume (https://jsonresume.org/)
- Charts: Recharts (for analytics visualizations)
- Payments: Stripe (for subscription plans and checkout)
- Desktop App: Electron (for AI Interview Buddy companion app)
📖 See DEVELOPMENT.md for the full local development setup guide.
📖 See DEPLOYMENT.md for the complete deployment guide with automatic deployment setup for Netlify and Heroku.
Contributions are welcome! Here is how to get involved:
- Fork the repository and create your branch from
main. - Follow the DEVELOPMENT.md guide to get a local environment working.
- Make your changes — keep PRs focused on a single concern.
- Open a Pull Request with a clear description of the problem and solution.
By submitting a PR you agree that your contribution will be licensed under the same MIT + Commons Clause terms as the rest of the project.
For bug reports and feature requests please open a GitHub Issue.
This project is licensed under the MIT License with the Commons Clause condition. See the LICENSE file for the full legal text.
In short:
- ✅ Free to read, fork, modify, and run for personal/non-commercial use.
- ✅ Contributions via pull requests are welcome.
- ❌ You may not host or sell VibeHired (or a substantially similar product) as a commercial service without written permission from the copyright holder.
The official hosted service at vibehired.ganainy.dev is operated and monetised exclusively by the project author.
| Feature | Description | Screenshot |
|---|---|---|
| Login / Register | Secure email/password login and Google OAuth sign-in. Create a new account to get started. |  |
| Forgot Password | Request a password reset link by email. |  |
| Email Inbox | Gmail-powered inbox that automatically scans your emails every 15 minutes. AI detects status changes, writes rich notes (salary, prep advice, key facts), and extracts calendar events — each surfaced as an independent action on the card. Nothing is applied until you confirm. |  |
| Dashboard | The main dashboard provides a comprehensive view of all job applications with filtering, sorting, and quick actions. |  |
| Analytics Dashboard | Visual dashboard with real-time metrics, status trends, weekly application goals, and pipeline yield analysis. |  |
| Job Details | View detailed job information and manage individual job applications. |  |
| Custom Job CV | Review and customize AI-generated CVs tailored to specific job applications. |  |
| Custom Job Cover Letter | Review and customize AI-generated cover letters tailored to specific job applications. |  |
| ATS Analysis | Get detailed ATS compatibility scores and feedback to optimize your application. |  |
| CV Management | Upload, parse, and edit your CV with a rich editor that supports section-by-section editing and AI-powered analysis. |  |
| Portfolio Setup | Single-page portfolio configurator — connect GitHub to import repos, sync LinkedIn data, set a custom username, and toggle public visibility. |  |
| Public Portfolio | Share your professional portfolio with a clean, modern public page. |  |
| Settings | View and manage your credit balance, usage statistics, and optional integrations (Apify for LinkedIn, GitHub token for portfolio). |  |
| Subscriptions | View, select, and manage your active features and tier limits with secure Stripe payment integration. |  |
| Work Tracker | Log work sessions with AI-powered voice commands, type-filter pills, automatic past-entry completion, and linked Google Calendar events. |  |
| Google Calendar | View your synced Google Calendar events, schedule interviews, manage tasks, and stay on top of your timeline directly within the app. |  |
| Mock Interview | AI-powered mock interview practice with separate first and second round prompt options per job application. |  |
| Admin Dashboard | Internal admin panel with AI call tracking, Apify usage statistics, user activity overview, and system health monitoring. |  |
| AI Interview Buddy | Electron companion app with push-to-talk (Ctrl+Shift+Space), stealth screen-share overlay, and real-time Gemini AI answers during live interviews. Currently in development — available to admins only. | COMING SOON |
| Prep Library | Global view of all interview preparation materials shared across jobs — grouped by company with search and flat/grouped toggle. Click any card to preview PDFs, images, or rendered Markdown inline. |  |
| Prep Library - Upload Queue | Multi-file upload flow with queued processing and progress states for adding preparation assets. |  |
| Prep Library - Inline Preview | Material preview experience for PDFs, images, and markdown/text content directly inside the prep workspace. |  |