Skip to content

Ayushpremrocks/Hire-Orbit

Repository files navigation

Hire Orbit

An Innovative AI-Powered Job Portal

Hire Orbit is a comprehensive job portal platform that connects candidates and recruiters with advanced AI-powered resume analysis capabilities. Built with Next.js and integrated with Google Gemini AI, it provides intelligent resume optimization and job matching features.

πŸš€ Features

Core Platform Features

  • Login and SignUp for both candidates and recruiters
  • Dark Mode and Light Mode
  • Membership Plans with payment functionality
  • Responsive design for desktop and mobile
  • Vercel web analytics integration
  • Social feed for tech-related posts with images and timestamps

πŸ€– AI-Powered Resume Analysis

  • Upload PDF resumes with automatic text extraction
  • Analyze resumes against job descriptions using Google Gemini AI
  • Get ATS (Applicant Tracking System) scores
  • Identify missing keywords for better job matching
  • Receive personalized improvement suggestions
  • Real-time analysis with loading indicators

πŸ‘₯ Candidate Features

  • Create and update profiles with a resume in "Account"
  • In the membership section, candidates can choose a plan to apply for multiple job posts simultaneously
  • List of companies that have posted jobs in the Company section
  • List of all jobs in the Jobs section with various filters
  • In the Activity section, candidates can track the jobs they've applied to, and see where they've been selected or rejected
  • AI Resume Analyzer: Upload resume and get AI-powered analysis against job descriptions

🏒 Recruiter Features

  • Create and update profiles in "Account"
  • In the membership section, recruiters can choose a plan to post jobs for multiple roles
  • In the Jobs section, recruiters can see how many candidates have applied for each role
  • By clicking on a role, recruiters can view the list of candidates who have applied
  • Recruiters can then click "View Profile" to see the candidate's profile and resume, and make a decision to select or reject the candidate

πŸ› οΈ Tech Stack

  • Frontend: Next.js 14, React, Tailwind CSS
  • AI Integration: Google Generative AI (Gemini 1.5 Flash)
  • PDF Processing: react-pdftotext
  • UI Components: Custom components with shadcn/ui
  • Database: MongoDB (inferred from models structure)
  • Authentication: Clerk (inferred from sign-in/sign-up structure)
  • Deployment: Vercel

πŸ“‹ Prerequisites

  • Node.js (v18 or above recommended)
  • npm or yarn
  • Google Generative AI API Key (Get one here)
  • MongoDB database (for user data and job postings)

πŸš€ Getting Started

Installation

  1. Clone the repository:

    git clone https://github.com/Ayushpremrocks/Hire-Orbit.git
    cd Hire-Orbit
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Environment Setup: Create a .env.local file in the root directory and add your environment variables:

    # Google AI API Key
    GOOGLE_API_KEY=your_google_api_key_here
    
    # Database
    MONGODB_URI=your_mongodb_connection_string
    
    # Clerk Authentication (if using)
    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
    CLERK_SECRET_KEY=your_clerk_secret_key
    
    # Other environment variables as needed
  4. Run the development server:

    npm run dev
    # or
    yarn dev
  5. Open your browser: Navigate to http://localhost:3000 to see the application.

πŸ“ Project Structure

src/
β”œβ”€β”€ app/                    # Next.js app directory
β”‚   β”œβ”€β”€ account/           # User account pages
β”‚   β”œβ”€β”€ activity/          # User activity tracking
β”‚   β”œβ”€β”€ analyzer/          # AI resume analyzer
β”‚   β”œβ”€β”€ companies/         # Company listings
β”‚   β”œβ”€β”€ feed/              # Social feed
β”‚   β”œβ”€β”€ jobs/              # Job listings
β”‚   β”œβ”€β”€ membership/        # Subscription plans
β”‚   β”œβ”€β”€ onboard/           # User onboarding
β”‚   └── sign-in/sign-up/   # Authentication pages
β”œβ”€β”€ components/            # Reusable React components
β”‚   β”œβ”€β”€ analyzeResume/     # Resume analysis component
β”‚   β”œβ”€β”€ ui/                # UI components (buttons, cards, etc.)
β”‚   └── magicui/           # Enhanced UI components
β”œβ”€β”€ database/              # Database connection and queries
β”œβ”€β”€ models/                # Data models (User, Job, Application, etc.)
β”œβ”€β”€ lib/                   # Utility functions
└── utils/                 # Helper functions

🎯 Key Features Breakdown

AI Resume Analyzer

The platform's standout feature uses Google Gemini AI to:

  • Extract text from uploaded PDF resumes
  • Compare resume content against job descriptions
  • Generate ATS compatibility scores
  • Identify missing keywords that could improve job matching
  • Provide actionable suggestions for resume improvement
  • Personalize feedback using the candidate's name from the resume

User Management

  • Dual User Types: Separate flows for candidates and recruiters
  • Profile Management: Comprehensive profile creation and editing
  • Activity Tracking: Real-time tracking of applications and hiring decisions

Membership System

  • Tiered Plans: Different subscription levels for enhanced features
  • Payment Integration: Secure payment processing for premium features

πŸ”§ Configuration

Google AI Setup

  1. Visit Google AI Studio
  2. Create a new API key
  3. Add it to your .env.local file as GOOGLE_API_KEY

Database Setup

Configure your MongoDB connection string in the environment variables.

Environment Variables

This project uses environment variables for secrets and configuration. Do not commit real secrets.

  1. Copy .env.example to .env.local:
    # Windows (PowerShell)
    Copy-Item .env.example .env.local
    # or CMD
    copy .env.example .env.local
  2. Fill in the values in .env.local:
    • URL – Base app URL (http://localhost:3000 for local)
    • MONGODB_URL – MongoDB connection string
    • STRIPE_SECRET_KEY – Stripe Secret Key
    • GOOGLE_API_KEY – Google Generative AI (Gemini) API key
    • NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY – Clerk publishable key
    • CLERK_SECRET_KEY – Clerk secret key

Git is configured to ignore .env* files. Share .env.example only.

πŸ“ Usage

  1. For Candidates:

    • Sign up and create your profile
    • Upload your resume in the analyzer section
    • Paste job descriptions to get AI-powered analysis
    • Apply for jobs and track your applications
  2. For Recruiters:

    • Sign up and create your company profile
    • Post job openings
    • Review candidate applications
    • Use AI insights to make better hiring decisions

🀝 Contributing

  1. Fork the repository
  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

πŸ“„ License

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

πŸ™ Acknowledgements

πŸ“ž Support

If you have any questions or need help, please open an issue in the GitHub repository.


Made with ❀️ by Ayushpremrocks

About

A full-stack recruitment portal with dual user flows, job management, subscriptions, and professional networking.

Resources

License

Stars

Watchers

Forks

Contributors