AI Resume Builder

Turn your experience into an interview-ready resume.

AI Resume Builder is a full-stack web application that simplifies the resume creation process. It leverages AI to analyze your inputs and generate professional, ATS-friendly content tailored to your specific industry and job role.

Let the intelligent formatting engine handle the design and layout while you focus on taking the next step in your career.

• AI-Powered Content Generation: Automatically generate compelling summaries and experience bullet points using Google's Gemini 2.5 Flash model.
• Dynamic 3D UI Elements: Engaging, interactive 3D landing page components built with React Three Fiber and Framer Motion.
• Secure Authentication: Robust authentication system combining custom JWT (HttpOnly cookies) and Google OAuth.
• Live Preview & PDF Export: See changes to your resume in real-time and export a clean, formatted PDF instantly.
• Public Sharing: Generate a unique, shareable URL for your resume to send to recruiters.

Frontend

• Framework: React 18 (Vite)
• Styling & UI: Tailwind CSS, Radix UI
• Animations & 3D: Framer Motion, Three.js (@react-three/fiber, @react-three/drei)
• Routing: React Router DOM

Backend

• Runtime: Node.js
• Framework: Express.js
• Database: MongoDB (Mongoose)
• Auth: jsonwebtoken, google-auth-library, bcryptjs
• AI Integration: @google/genai (Server), @google/generative-ai (Client)

Deployment

• Frontend: Netlify
• Backend API: Render

This repository uses a decoupled Client-Server architecture:

1. Client (/client): A Vite-powered React SPA that handles UI rendering, 3D graphics, and client-side routing.
2. Server (/server): A Node/Express REST API that manages MongoDB read/writes, JWT session cookies, and secure proxying of prompts to the Google Gemini API.

Note: The production build is configured via a postinstall script to serve the compiled Vite frontend statically from the Node server.

• Node.js (v18 or higher recommended)
• MongoDB (Local instance or MongoDB Atlas cluster)
• Gemini API Key (Get one from Google AI Studio)
• Google OAuth Client ID (For Google Sign-In)

1. Clone the repository:

   git clone https://github.com/pran-ekaiva006/AI-resume_builder.git
   cd AI-resume_builder

2. Install Client Dependencies:

   cd client
   npm install

3. Install Server Dependencies:

   cd ../server
   npm install

You need to set up .env files in both the client and server directories. Copy the provided .env.example files:

Open two separate terminal instances:

Terminal 1 (Frontend):

cd client
npm run dev

Terminal 2 (Backend):

cd server
npm run dev

(The backend runs on http://localhost:5001 and the frontend runs on http://localhost:5173)

AI-resume_builder/
├── client/                 # Frontend React Application
│   ├── public/             # Static assets (images, logos)
│   ├── service/            # Global Axios API configuration
│   └── src/
│       ├── assets/         # Home page & banner assets
│       ├── auth/           # Authentication pages (Sign In, Sign Up, Reset)
│       ├── components/     # Reusable UI & custom components
│       ├── context/        # React Context (Auth, ResumeInfo)
│       ├── dashboard/      # Dashboard and Resume Editor interface
│       └── my-resume/      # Public/Live preview routes
├── server/                 # Backend Express API
│   ├── controllers/        # Route logic (Auth, Resumes)
│   ├── middlewares/        # JWT & rate-limiting middleware
│   ├── models/             # Mongoose schemas (Resume, User)
│   └── routes/             # Express API routes (aiRoutes, authRoutes, resumeRoutes)
└── README.md

Contributions, issues, and feature requests are welcome!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

Pranjal Kumar Verma

• GitHub: @pran-ekaiva006