Skip to content

Latest commit

 

History

History
69 lines (53 loc) · 1.81 KB

README.md

File metadata and controls

69 lines (53 loc) · 1.81 KB

MAC Job Board

Hey there! 👋

This is a modern, intelligent job board platform that automatically aggregates job listings, providing users with a streamlined experience to search, filter, and discover relevant opportunities. The platform updates daily with fresh listings through our smart AI robots.

Features 🚀

  • Jobs update automatically every single day from various sources (automatically deduplicated)
  • We use AI to help fix, sort and summarise the listings
  • You can filter for exactly what you want (e.g. Big Tech Intern Roles for Interational students)
  • Works perfectly on phone or laptop

Frontend

  • Next.js 15: Utilizing the App Router for server-side rendering and optimized client-side navigation
  • React 19: For building the interactive user interface components
  • TypeScript: Ensuring type safety across the codebase
  • Mantine UI: For consistent, accessible UI components
  • Tailwind CSS: For utility-first styling and responsive design

Backend

  • Server Actions: Answers search and feedback requests
  • MongoDB: Stores job listings and related metadata
  • GoLang: Powers our web robots (this part is not open source)

Getting Started

Prerequisites

  • Node.js 20+
  • Java 17
  • Go 1.21+
  • Docker & Docker Compose
  • Redis

Local Development

# Start all services
docker compose -f docker-compose.dev.yml up
# Alternative if Make is installed
make dev

# Frontend only
cd frontend
npm install
npm run dev

# Backend only
cd backend
./gradlew bootRun

Development Guidelines

Git Workflow

Branch Structure

  • main - Production branch
  • dev - Development branch
  • Feature branches follow the pattern: 
    <component>/<developer>/<feature-name>
Examples:
- backend/edwn/redis-caching
- frontend/sarah/job-filters

License

This project is licensed under the MIT License.