CareerForge AI is an all-in-one AI-powered SaaS platform for job seekers. It features a complete web application with authentication, a Kanban board for tracking applications, and AI-driven resume optimization and cover letter generation.
- Frontend: React 19, Vite, Tailwind CSS v4, Framer Motion, Zustand, TanStack Query, React Router v7.
- Backend: Node.js, Express, TypeScript, Prisma (PostgreSQL).
- AI integration: Groq SDK (
llama3-8b-8192). - Auth & Database: Supabase.
- Dashboard: Track overall job application stats and visualize recent activity.
- Kanban Board: Drag and drop applications through stages (To Apply, Applied, Interviewing, Offer, etc.).
- Resume Hub: Upload and store multiple tailored resumes as PDFs.
- AI Resume Optimizer: Automatically rewrite resume content to match target job descriptions.
- AI Cover Letter Generator: Generate professional, context-aware cover letters in seconds given a job description.
- Premium UI: Crafted with a glassmorphism and modern dark-mode enabled design system. Includes a fully functional
Cmd+Kcommand palette.
-
Clone the repository and install dependencies
npm run install:all
-
Configure Environment Variables
- In
/backend, copy.env.example(or set the missing placeholders in.env) to point to your Supabase and PostgreSQL connection URLs alongside yourGROQ_API_KEY. - In
/frontend, ensure your.envpoints to your backend and Supabase instance.
- In
-
Database Setup
cd backend npx prisma generate npx prisma db push -
Run Development Server From the root folder, launch both frontend and backend concurrently:
npm run dev
The web app will run on http://localhost:5173 and the API will be available on http://localhost:3001.