📄 CareerForge AI: The Ultimate Career Suite

CareerForge AI is a cutting-edge, AI-driven career management platform engineered to help professionals craft stunning, ATS-optimized resumes, track applications, and prepare for interviews. Built on a modern Next.js stack, it seamlessly blends real-time editing with powerful AI generation capabilities to accelerate your job hunt.

---

✨ Key Features

• ✨ Magic AI Suite: A centralized command center for next-gen career tools:
  • 🧠 Mind-Reader: Generates recruiter attention heatmaps based on senior technical recruiter eye-tracking data.
  • 🛡️ Liar Detector: An AI-driven veracity audit that detects temporal inconsistencies and skill-experience gaps.
  • ⏳ Time-Traveler: Projects your professional trajectory to 2030, evolving your skills and roles for the future market.
  • 🎙️ Podcast Resume: Converts your resume into a 2-minute high-impact AI interview podcast.
  • 🔥 Resume Roast: Brutally honest AI critiques to eliminate corporate fluff and highlighting weaknesses.
  • 💻 Hacker Mode: A terminal-based resume editor for the power user who builds in the command line.
• 🧠 Advanced AI Generation: Instantly generate tailored professional summaries, bullet points, and descriptions powered by NVIDIA & Groq.
• 💼 Kanban Job Tracker: A comprehensive application pipeline to manage your interview stages, notes, and specific resume versions.
• ✉️ AI Cover Letter Generator: Create personalized, job-specific cover letters that leverage your resume data.
• 🎯 Skill Gap Analyzer: Get data-driven insights into missing skills and industry trends with course recommendations.
• 🎙️ AI Interview Coach: Prepare with role-specific interview questions and AI-powered feedback.
• 🎨 Custom Layout Builder: Take full control of your resume architecture with section reordering, custom typography, and adjustable spacing.
• ⚡ Real-Time Live Preview: Watch your resume take shape as you type. What you see is exactly what you get.
• 🔗 Shareable Public Links: Generate unique, secure links to share your dynamic web-based resume with recruiters instantly.
• 🔒 Secure Authentication: Enterprise-grade user authentication and session management powered by Clerk.

🏗️ Architecture & Tech Stack

CareerForge AI is architected for performance, scalability, and developer experience:

• Frontend: Next.js 14 (App Router), React 18, Tailwind CSS, Shadcn UI, Framer Motion
• Backend: Next.js API Routes, Hono (RPC), TanStack React Query
• Database: PostgreSQL (Neon DB), Drizzle ORM
• AI Integration: Groq API (Llama 3 models)
• Document Processing: jsPDF, html2canvas
• Authentication: Clerk

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• npm or yarn
• A PostgreSQL Database (e.g., Neon or Vercel Postgres)
• API Keys for Clerk and Groq

Installation

1. Clone the repository

   git clone https://github.com/yourusername/AI-Resumes-Builder.git
   cd AI-Resumes-Builder

2. Install dependencies

   npm install

3. Environment Setup Create a .env file in the root directory and add your credentials (refer to .env.example):

   # Database
   DATABASE_URL=your_postgres_connection_string
   POSTGRES_URL=your_postgres_connection_string
   
   # Clerk Authentication
   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
   CLERK_SECRET_KEY=your_clerk_secret_key
   NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
   NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
   NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
   NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard
   
   # AI Integration
   GROQ_API_KEY=your_groq_api_key
   NVIDIA_KIMI_KEY=your_nvidia_kimi_key
   NVIDIA_IMAGE_KEY=your_nvidia_image_key
   
   # Analytics
   ANALYTICS_SALT=use_a_long_random_string
   
   # App URL
   NEXT_PUBLIC_APP_URL=http://localhost:3000

4. Initialize Database Push the schema to your database:

   npm run db:push

5. Start Development Server

   npm run dev

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

📂 Project Structure

├── app/                        # Next.js 14 App Router
│   ├── (auth)/                 # Clerk Authentication routes
│   ├── (home)/                 # Main Application Workspace
│   │   ├── dashboard/          # User Dashboard & Document Management
│   │   ├── _components/        # Dashboard-specific UI & Forms
│   │   └── layout.tsx          # Main layout with Header & Mobile Customizer
│   ├── (landingPage)/          # Public Marketing & Hero section
│   ├── (public)/               # Public Portfolio & Live Preview routes
│   └── api/                    # Hono RPC Backend (Document, AI, ATS Engine)
├── components/                 # Shared UI Component Library
│   ├── preview/                # Resume Preview specific modules
│   └── ui/                     # Core Shadcn UI components
├── context/                    # Global State Management (Resume Context)
├── db/                         # Database & Persistence Layer
│   └── schema/                 # Drizzle ORM Table & Relation Definitions
├── features/                   # Logic-heavy Domain Features
│   ├── document/               # TanStack Query hooks for Document CRUD
│   └── ai/                     # AI content generation logic
├── hooks/                      # Global Custom React Hooks
├── lib/                        # Core Utilities & External API Clients
├── public/                     # Static Assets & Global Styles
└── types/                      # Shared TypeScript Type Definitions

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License.