JobHouse - Smart Job Application Platform

JobHouse is a modern web application that helps job seekers find and apply for jobs with intelligent resume analysis and ATS score prediction.

Features

• 🔍 Smart job search with location and filter options
• 📊 Real-time ATS (Applicant Tracking System) score analysis
• 📝 Resume keyword matching for job applications
• 📱 Responsive design for all devices
• 🔄 Profile skills integration for better job matching
• 📄 PDF resume parsing and text extraction

Technologies

• Frontend: Next.js, React, TypeScript, Tailwind CSS
• PDF Processing: react-pdftotext
• State Management: React Hooks
• Styling: Tailwind CSS, CSS-in-JS
• Data Storage: Local Storage (for demo purposes)
• Hosting: Vercel (Serverless Functions, Edge Network)
• Database: PostgreSQL with Neon.tech (Serverless Postgres)
• ORM: Prisma (Type-safe database client)

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v16.x or later)
• npm (v8.x or later) or yarn (v1.22.x or later)
• Git

Installation

Option 1: Using the Setup Script (Recommended)

For Linux/macOS users, we provide a convenient setup script:

cd jobhouse

# Make the script executable (if needed)
chmod +x setup.sh

# Run the setup script
./setup.sh

The script will:

• Check for required dependencies
• Install project dependencies
• Create a sample .env.local file
• Build the project
• Provide usage instructions

Option 2: Manual Installation

1. Go to the repository:

cd jobhouse

2. Install dependencies:

npm install
# or
yarn install

3. Create a .env.local file in the project root and add any required environment variables:

# Example environment variables (update as needed)
NEXT_PUBLIC_API_URL=your_api_url_here

Running the Project

Development Mode

To run the project in development mode with hot-reload:

npm run dev
# or
yarn dev

The application will be available at http://localhost:3000.

Production Build

To build the project for production:

npm run build
# or
yarn build

To start the production server:

npm start
# or
yarn start

Usage Guide

Job Search

1. Navigate to the Jobs page
2. Enter job title/keywords and location
3. Apply additional filters if needed
4. Browse through job listings
5. Click on a job to view details

Resume Analysis

1. Upload your resume PDF on the Apply page
2. View your profile and add relevant skills
3. Visit a job listing to see your ATS score and keyword analysis
4. Follow the suggested improvements to enhance your resume

Account Management

1. Create a user profile with your information
2. Add skills and experience to your profile
3. Upload and manage your resume
4. Track jobs you've applied to

Project Structure

jobhouse/
├── app/                # Next.js app directory with pages
├── components/         # React components
├── lib/                # Utility functions
│   └── keyword-extractor.ts  # Resume analysis utilities
├── public/             # Static files
└── styles/             # Global styles