🚀 Hireek — Modern SaaS Recruitment Platform

Connect Companies with Top Talent Seamlessly

Hireek is a full-featured SaaS recruitment platform that bridges the gap between companies and job seekers. Built with cutting-edge technologies, it delivers a seamless, secure, and lightning-fast hiring experience for both employers and candidates.

Features • Tech Stack • Getting Started • Documentation • Deployment

🌟 Overview

Hireek is designed to revolutionize the recruitment process by providing:

🏢 For Companies: Post jobs, manage applications, review candidates, and hire top talent
👔 For Job Seekers: Discover opportunities, submit applications, track progress, and land dream jobs
🔒 Enterprise Security: Powered by Arcjet for bot protection and runtime security
⚡ Blazing Fast: Built on Next.js 15 with App Router and React Server Components
🌐 Production Ready: Deployed on Vercel with edge performance globally

✨ Features

🔐 Authentication & Security

🔑 OAuth authentication via Google and GitHub (Auth.js v5-beta)
🛡️ Enterprise-grade security with Arcjet (bot protection, rate limiting)
👤 Role-based access control (Company vs Job Seeker)
🔒 Secure session management

🏢 Company Dashboard

✅ Guided onboarding flow for company setup
📝 Create, edit, and manage job postings (draft/active/expired states)
👥 Review and manage candidate applications
⭐ Mark favorite candidates
📊 Track job post performance and expiration
💼 Company profile with logo, website, and social links

👔 Job Seeker Dashboard

📄 Profile creation with resume uploads via UploadThings
🔍 Browse and search job listings
📤 Submit applications with cover letters
📊 Track application history and status
⭐ Save favorite job posts
🔔 Receive notifications

⚙️ Power Features

📬 Background Jobs: Automated job expiration workflows via Inngest
💳 Payments: Stripe integration for premium listings and subscriptions
📤 File Uploads: Seamless resume and logo uploads via UploadThings
🎨 Modern UI: Beautiful components from shadcn/ui with Tailwind CSS
🌙 Dark Mode: Full dark/light theme support with next-themes
💨 Optimized UX: Skeleton loaders and optimistic UI updates
📱 Responsive Design: Mobile-first, works flawlessly on all devices
📧 Email Notifications: Transactional emails via Resend

🛠 Tech Stack

Frontend

Technology	Purpose
Next.js 15	React framework with App Router, RSC, and SSR
React 19	UI library with latest features
TypeScript	Type-safe development
Tailwind CSS	Utility-first CSS framework
shadcn/ui	Beautiful, accessible component library
next-themes	Dark mode implementation
Lucide React	Beautiful icon library

Backend & Database

Technology	Purpose
Prisma	Next-generation ORM
Neon PostgreSQL	Serverless Postgres database
Auth.js	OAuth authentication
Zod	TypeScript-first schema validation

Infrastructure & Services

Technology	Purpose
Vercel	Deployment and hosting
Arcjet	Security (bot protection, rate limiting)
Inngest	Background job processing
UploadThings	File uploads and management
Stripe	Payment processing
Resend	Transactional emails

Development Tools

Technology	Purpose
pnpm	Fast, disk space efficient package manager
ESLint	Code linting and quality
Turbopack	Next-gen bundler for faster dev

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Node.js 20.x or higher
pnpm 9.x or higher
PostgreSQL database (we recommend Neon for serverless)
Git for version control

Installation

Clone the repository

git clone https://github.com/ayoubhayda/hireek-platform.git
cd hireek-platform

Install dependencies

pnpm install

Environment Configuration

Create environment file

Copy the example environment file:

cp .env.exemple .env.local

Configure environment variables

Open .env.local and fill in the following variables:

# =============================================================================
# Authentication (Auth.js)
# =============================================================================
# Generate a secret: npx auth secret
AUTH_SECRET=""

# Google OAuth
# Get credentials: https://console.cloud.google.com/apis/credentials
AUTH_GOOGLE_ID=""
AUTH_GOOGLE_SECRET=""

# GitHub OAuth
# Get credentials: https://github.com/settings/developers
AUTH_GITHUB_ID=""
AUTH_GITHUB_SECRET=""

# =============================================================================
# Database (Neon PostgreSQL)
# =============================================================================
# Get your connection string: https://console.neon.tech/
DATABASE_URL=""

# =============================================================================
# File Uploads (UploadThings)
# =============================================================================
# Get your token: https://uploadthing.com/dashboard
UPLOADTHING_TOKEN=""

# =============================================================================
# Security (Arcjet)
# =============================================================================
# Get your key: https://app.arcjet.com/
ARCJET_KEY=""

# =============================================================================
# Payments (Stripe)
# =============================================================================
# Get keys: https://dashboard.stripe.com/apikeys
SECRET_STRIPE_KEY=""
STRIPE_WEBHOOK_SECRET=""

# =============================================================================
# Email (Resend)
# =============================================================================
# Get key: https://resend.com/api-keys
RESEND_API_KEY=""

# =============================================================================
# Application
# =============================================================================
# Your app URL (use http://localhost:3000 for development)
NEXT_PUBLIC_BASE_URL="http://localhost:3000"

📝 How to Get Each API Key

Auth.js Secret

npx auth secret

Google OAuth

Go to Google Cloud Console
Create a new project or select existing
Enable Google+ API
Create OAuth 2.0 credentials
Add authorized redirect URI: http://localhost:3000/api/auth/callback/google

GitHub OAuth

Go to GitHub Developer Settings
Create new OAuth App
Set callback URL: http://localhost:3000/api/auth/callback/github

Neon PostgreSQL

Sign up at Neon
Create a new project
Copy the connection string from the dashboard

UploadThings

Sign up at UploadThings
Create a new app
Copy the token from settings

Arcjet

Sign up at Arcjet
Create a new site
Copy the API key

Stripe

Sign up at Stripe
Get your secret key from the API keys page
For webhooks, install Stripe CLI and run stripe listen --forward-to localhost:3000/api/webhooks/stripe

Resend

Sign up at Resend
Create an API key from the dashboard

Database Setup

Initialize the database

Push the Prisma schema to your database:

pnpm dlx prisma db push

(Optional) Open Prisma Studio

Explore your database with a visual editor:

pnpm dlx prisma studio

Running the Application

Start the development server

pnpm dev

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

📁 Project Structure

hireek-platform/
├── src/
│   ├── app/                      # Next.js App Router pages
│   │   ├── (auth)/              # Authentication routes
│   │   ├── (dashboard)/         # Protected dashboard routes
│   │   ├── api/                 # API routes
│   │   └── layout.tsx           # Root layout
│   ├── components/              # React components
│   │   ├── ui/                  # shadcn/ui components
│   │   ├── forms/               # Form components
│   │   └── ...                  # Feature components
│   ├── lib/                     # Utility libraries
│   │   ├── auth.ts              # Auth.js configuration
│   │   ├── db.ts                # Prisma client
│   │   └── stripe.ts            # Stripe configuration
│   ├── utils/                   # Helper functions
│   ├── inngest/                 # Background job functions
│   ├── generated/               # Prisma generated client
│   └── constants/               # App constants
├── prisma/
│   └── schema.prisma            # Database schema
├── public/                      # Static assets
├── .env.local                   # Environment variables (create this)
├── .env.exemple                 # Environment template
├── next.config.ts               # Next.js configuration
├── tailwind.config.ts           # Tailwind configuration
├── tsconfig.json                # TypeScript configuration
└── package.json                 # Dependencies

🗄 Database Schema

The platform uses the following core models:

Core Models

model User {
  id                   String    @id @default(cuid())
  email                String    @unique
  name                 String?
  userType             UserType? (COMPANY | JOB_SEEKER)
  onboardingComplete   Boolean   @default(false)
  company              Company?
  jobSeeker            JobSeeker?
  savedJobs            SavedJob[]
}

model Company {
  id        String   @id @default(cuid())
  name      String
  location  String
  about     String
  website   String
  logo      String
  jobs      Job[]
}

model JobSeeker {
  id              String           @id @default(cuid())
  name            String
  about           String
  resume          String
  jobApplications JobApplication[]
}

model Job {
  id              String      @id @default(cuid())
  jobTitle        String
  jobDescription  String
  employmentType  String
  location        String
  salaryFrom      Int
  salaryTo        Int
  benefits        String[]
  status          JobStatus   (DRAFT | ACTIVE | EXPIRED)
  jobApplications JobApplication[]
}

model JobApplication {
  id            String    @id @default(cuid())
  jobId         String
  jobSeekerId   String
  resume        String
  coverLetter   String?
  prevPosition  String?
  prevCompany   String?
}

For the complete schema, see prisma/schema.prisma.

📜 Available Scripts

Command	Description
`pnpm dev`	Start development server with Turbopack
`pnpm build`	Build production bundle
`pnpm start`	Start production server
`pnpm lint`	Run ESLint for code quality
`pnpm dlx prisma studio`	Open Prisma Studio (database GUI)
`pnpm dlx prisma db push`	Push schema changes to database
`pnpm dlx prisma generate`	Generate Prisma Client

🌐 Deployment

Deploy to Vercel (Recommended)

Hireek is optimized for Vercel deployment:

Push your code to GitHub

git add .
git commit -m "Initial commit"
git push origin main

Import to Vercel
- Go to Vercel
- Import your GitHub repository
- Vercel will auto-detect Next.js
Configure Environment Variables
- Add all environment variables from .env.local
- Don't forget to update NEXT_PUBLIC_BASE_URL to your production domain
Deploy
- Click "Deploy"
- Your app will be live in ~2 minutes! 🚀

Other Platforms

Hireek can be deployed to any platform that supports Next.js:

Netlify: Use the Next.js runtime
Railway: Deploy with PostgreSQL add-on
AWS/DigitalOcean: Deploy as a Node.js application
Docker: Create a Dockerfile for containerized deployment

🧪 Testing

Coming Soon: Comprehensive test suite

Planned testing tools:

Jest: Unit and integration tests
Playwright: End-to-end testing
React Testing Library: Component testing
Vitest: Fast unit tests

🤝 Contributing

Contributions are welcome! Here's how you can help:

Fork the repository
Create a feature branch
```
git checkout -b feature/amazing-feature
```
Commit your changes
```
git commit -m "Add amazing feature"
```
Push to the branch
```
git push origin feature/amazing-feature
```
Open a Pull Request

Development Guidelines

Follow the existing code style
Write meaningful commit messages
Add tests for new features
Update documentation as needed
Ensure all tests pass before submitting PR

📄 License

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

🙏 Acknowledgments

Built with amazing tools and services:

Next.js – The React Framework for the Web
Prisma – Next-generation ORM
Neon – Serverless Postgres
Inngest – Background job orchestration
Arcjet – Application security
UploadThings – File uploads
shadcn/ui – Beautiful components
Tailwind CSS – Utility-first CSS
Vercel – Deployment platform

📧 Contact & Support

Author: Ayoub Hayda
GitHub: @ayoubhayda
Repository: hireek-platform

⭐ Star this repo if you find it helpful!

Made with ❤️ by Ayoub Hayda

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
prisma		prisma
public		public
src		src
.env.exemple		.env.exemple
.eslintignore		.eslintignore
.gitignore		.gitignore
README.md		README.md
components.json		components.json
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🚀 Hireek — Modern SaaS Recruitment Platform

Connect Companies with Top Talent Seamlessly

📖 Table of Contents

🌟 Overview

✨ Features

🔐 Authentication & Security

🏢 Company Dashboard

👔 Job Seeker Dashboard

⚙️ Power Features

🛠 Tech Stack

Frontend

Backend & Database

Infrastructure & Services

Development Tools

🚀 Getting Started

Prerequisites

Installation

Environment Configuration

Auth.js Secret

Google OAuth

GitHub OAuth

Neon PostgreSQL

UploadThings

Arcjet

Stripe

Resend

Database Setup

Running the Application

📁 Project Structure

🗄 Database Schema

Core Models

📜 Available Scripts

🌐 Deployment

Deploy to Vercel (Recommended)

Other Platforms

🧪 Testing

🤝 Contributing

Development Guidelines

📄 License

🙏 Acknowledgments

📧 Contact & Support

⭐ Star this repo if you find it helpful!

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages