Skip to content
/ Fullstack-Job-Application Public

Fully customizable for a Job Application Portal - no need to pay millions of $$$ for Workday or Greenhouse!

unc-gdsc.github.io/Fullstack-Job-Application/

License

MIT license
5 stars 1 fork Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

UNC-GDSC/Fullstack-Job-Application

BranchesTags

Repository files navigation

Job Application Portal

Node.js React MongoDB License PRs Welcome

A modern, production-ready job application platform built with the MERN stack (MongoDB, Express, React, Node.js).

Features • Tech Stack • Quick Start • API Docs • Contributing

Overview

This is a fully customizable, enterprise-grade job application platform that provides a complete solution for managing job postings and candidate applications. Built with modern technologies and best practices, it's ready for production deployment while remaining easy to customize for your specific needs.

Key Highlights

  • Full-Stack Solution: Complete backend API and responsive frontend
  • Production-Ready: Security hardening, rate limiting, input validation, and comprehensive error handling
  • Highly Customizable: Easy branding and feature configuration via environment variables
  • Docker Support: Containerized deployment with Docker Compose
  • API-First Design: RESTful API with comprehensive documentation
  • Modern UI: Built with Material UI for a polished, responsive experience
  • Developer-Friendly: ESLint, Prettier, testing setup, and detailed documentation

Features

Core Functionality

  • Job Management

    • Create, read, update, and delete job postings
    • Filter jobs by type and department
    • Pagination support for large datasets
    • Search and advanced filtering

  • Application Management

    • Submit applications with resume links and cover letters
    • View and manage candidate applications
    • Application filtering by job
    • Email validation and URL verification

Technical Features

  • Security

    • Helmet.js for HTTP header security
    • CORS with configurable origins
    • Rate limiting (100 requests per 15 minutes)
    • MongoDB injection protection
    • Input validation and sanitization
    • Request size limits

  • Developer Experience

    • Comprehensive API documentation
    • Jest and React Testing Library setup
    • ESLint and Prettier configuration
    • Hot reload in development
    • Docker and Docker Compose support
    • Sample test files included

  • Production Features

    • Environment-based configuration
    • Request logging with Morgan
    • Graceful error handling
    • Health check endpoints
    • CI/CD pipeline with GitHub Actions
    • Graceful shutdown handling

Technology Stack

Backend

  • Runtime: Node.js 20.x
  • Framework: Express 4.x
  • Database: MongoDB 7.x with Mongoose ODM
  • Security: Helmet, CORS, express-rate-limit, express-mongo-sanitize
  • Validation: express-validator
  • Logging: Morgan
  • Testing: Jest, Supertest

Frontend

  • Framework: React 18.x
  • UI Library: Material UI 5.x
  • HTTP Client: Axios
  • Build Tool: Create React App
  • Testing: Jest, React Testing Library

DevOps

  • Containerization: Docker, Docker Compose
  • CI/CD: GitHub Actions
  • Code Quality: ESLint, Prettier
  • Version Control: Git

Directory Structure

Fullstack-Job-Application/
├── backend/                  # Node.js backend
│   ├── config/              # Database configuration
│   │   └── db.js
│   ├── models/              # Mongoose models
│   │   ├── Job.js
│   │   └── Application.js
│   ├── routes/              # API routes
│   │   ├── jobs.js
│   │   └── applications.js
│   ├── __tests__/           # Backend tests
│   ├── .env.example         # Environment variables template
│   ├── Dockerfile           # Backend Docker configuration
│   ├── jest.config.js       # Jest configuration
│   ├── package.json
│   └── server.js            # Express server entry point
├── frontend/                # React frontend
│   ├── public/              # Static files
│   │   └── index.html
│   ├── src/
│   │   ├── components/      # React components
│   │   │   ├── Header.js
│   │   │   ├── Footer.js
│   │   │   ├── JobList.js
│   │   │   ├── JobForm.js
│   │   │   └── ApplicationForm.js
│   │   ├── styles/
│   │   │   └── main.css
│   │   ├── App.js
│   │   ├── config.js        # Frontend configuration
│   │   └── index.js
│   ├── .env.example         # Environment variables template
│   ├── Dockerfile           # Frontend Docker configuration
│   └── package.json
├── docs/                    # Documentation
│   └── API.md              # API documentation
├── .github/
│   └── workflows/
│       └── ci.yml          # CI/CD pipeline
├── docker-compose.yml       # Docker Compose configuration
├── package.json            # Root package.json for scripts
├── .eslintrc.json          # ESLint configuration
├── .prettierrc             # Prettier configuration
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Quick Start

Prerequisites

  • Node.js v18 or higher
  • npm v9 or higher
  • MongoDB (local instance or MongoDB Atlas)
  • Docker (optional, for containerized deployment)

Option 1: Local Development

1. Clone the Repository

git clone https://github.com/UNC-GDSC/Fullstack-Job-Application.git
cd Fullstack-Job-Application

2. Install All Dependencies

npm run install:all

3. Backend Setup

cd backend
cp .env.example .env
# Edit .env with your MongoDB connection string
npm run dev

Backend Environment Variables:

PORT=5000
NODE_ENV=development
MONGO_URI=mongodb://localhost:27017/job_applications_db
COMPANY_NAME=Your Company Name
COMPANY_LOGO_URL=https://example.com/logo.png
ALLOWED_ORIGINS=http://localhost:3000
RATE_LIMIT_WINDOW_MS=900000
RATE_LIMIT_MAX_REQUESTS=100

4. Frontend Setup

In a new terminal:

cd frontend
cp .env.example .env
# Edit .env if needed
npm start

Frontend Environment Variables:

REACT_APP_API_URL=http://localhost:5000
REACT_APP_COMPANY_NAME=Your Company Name
REACT_APP_COMPANY_LOGO_URL=https://example.com/logo.png

5. Access the Application

Option 2: Docker Deployment

# Start all services (MongoDB, Backend, Frontend)
npm run docker:up

# View logs
npm run docker:logs

# Stop all services
npm run docker:down

Access after Docker deployment:

Development

Running Tests

# Run all tests
npm test

# Backend tests only
npm run test:backend

# Frontend tests only
npm run test:frontend

# Frontend tests with coverage
cd frontend && npm run test:coverage

Code Quality

# Format all code
npm run format

# Check formatting
npm run format:check

# Lint code
npm run lint

# Fix linting issues
npm run lint:fix

Available Scripts

From the root directory:

  • npm run install:all - Install all dependencies
  • npm run dev - Run both frontend and backend in development mode
  • npm run dev:backend - Run backend only
  • npm run dev:frontend - Run frontend only
  • npm test - Run all tests
  • npm run lint - Lint all code
  • npm run format - Format all code
  • npm run docker:up - Start Docker containers
  • npm run docker:down - Stop Docker containers

API Documentation

Comprehensive API documentation is available in docs/API.md.

Quick API Reference

Jobs Endpoints

  • GET /api/jobs - Get all jobs (with pagination and filtering)
  • GET /api/jobs/:id - Get single job
  • POST /api/jobs - Create new job
  • PUT /api/jobs/:id - Update job
  • DELETE /api/jobs/:id - Delete job

Applications Endpoints

  • GET /api/applications - Get all applications
  • GET /api/applications/:id - Get single application
  • POST /api/applications - Submit application
  • DELETE /api/applications/:id - Delete application

Health Check

  • GET /api/health - API health status

Customization

Branding

Update environment variables in .env files:

Backend (backend/.env):

COMPANY_NAME=Acme Corporation
COMPANY_LOGO_URL=https://acme.com/logo.png

Frontend (frontend/.env):

REACT_APP_COMPANY_NAME=Acme Corporation
REACT_APP_COMPANY_LOGO_URL=https://acme.com/logo.png

UI Customization

  • Modify components in frontend/src/components/
  • Update Material UI theme in frontend/src/App.js
  • Adjust styles in frontend/src/styles/main.css

Backend Customization

  • Extend models in backend/models/
  • Add new routes in backend/routes/
  • Modify validation rules in route files
  • Add middleware in backend/server.js

Deployment

Environment Setup

  1. Set NODE_ENV=production in backend .env
  2. Configure production MongoDB URI
  3. Set proper CORS origins
  4. Configure secure secrets

Deployment Options

  • Heroku: Deploy backend and frontend separately
  • Vercel/Netlify: Frontend static hosting
  • AWS/Azure/GCP: Full-stack deployment with managed MongoDB
  • Docker: Use provided Docker Compose configuration
  • VPS: Deploy using PM2 or similar process manager

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Contribution Steps

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat: add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Testing

Backend Tests

cd backend
npm test                 # Run tests
npm run test:watch      # Watch mode

Frontend Tests

cd frontend
npm test                # Run tests
npm run test:watch     # Watch mode
npm run test:coverage  # Generate coverage report

Security

  • Input validation on all endpoints
  • Rate limiting to prevent abuse
  • MongoDB injection protection
  • Helmet.js for security headers
  • CORS configuration
  • Environment variable protection

Note: This application should have authentication/authorization implemented before production use.

Troubleshooting

MongoDB Connection Issues

  • Ensure MongoDB is running
  • Check MONGO_URI in .env
  • For MongoDB Atlas, whitelist your IP

Port Conflicts

  • Change PORT in backend .env
  • Update frontend API URL accordingly

Docker Issues

# Restart containers
npm run docker:down
npm run docker:up

# View logs
npm run docker:logs

# Rebuild containers
docker-compose up --build

License

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

Authors

Created and maintained by the UNC-Chapel Hill Google Developer Student Club (GDSC) team.

Acknowledgments

  • Material UI for the component library
  • MongoDB for the database solution
  • The open-source community for various packages and tools

Support

Made with ❤️ by UNC GDSC

⬆ back to top

About

Fully customizable for a Job Application Portal - no need to pay millions of $$$ for Workday or Greenhouse!

unc-gdsc.github.io/Fullstack-Job-Application/

Resources

Readme

License

MIT license

Contributing

Contributing
Activity
Custom properties

Stars

5 stars

Watchers

4 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages