Project Polaris – Interview Platform

Long before GPS and algorithms, explorers had just one reliable guide in the vast, star-studded sky— Polaris, the North Star. No matter how wild the storm or dark the night, Polaris pointed the way. That’s exactly what Project Polaris aims to be: a bright, unwavering signal in the messy universe of hiring. In a world of endless résumés, guesswork, and generic filters, Polaris doesn’t just scan—it discovers. It finds the spark, the potential, the perfect match that others miss. This isn’t just a hiring system; it’s your cosmic compass for finding extraordinary talent.

---

A full-stack application to streamline the technical interview process. Built using Node.js (backend) and React.js (frontend), the platform supports question management, candidate information, and scoring — empowering interviewers with the right tools for efficient evaluations.

---

📚 Table of Contents

• 🎯 Purpose
• 📁 Directory Structure
• 🧰 Tech Stack
• ⚙️ Setup Instructions
• 📜 Environment Variables
• 💡 Scripts
• 🤝 Contributing
• 📄 License

---

🎯 Purpose

This platform is designed to help interviewers:

• View and manage interviewee profiles
• Ask structured or custom questions
• Assign grades and feedback
• Track interview progress in real-time

---

📁 Directory Structure

Project-Polaris-InterviewPlatform/
│
├── .github/ # GitHub workflows (CI/CD, lint, tests, etc.)
│
├── backend/ # Node.js + Express backend
│ ├── node_modules/
│ ├── .env
│ ├── server.js
│ ├── google-credentials.json
│ ├── package.json
│ └── package-lock.json
│
├── frontend/ # React frontend app
│ ├── node_modules/
│ ├── public/
│ ├── src/
│ ├── .env
│ ├── .gitignore
│ ├── README.md
│ ├── package.json
│ └── package-lock.json
│
├── question.json # Question bank file (likely used for interview flow)
├── .gitignore
├── README.md # You are here
└── package-lock.json

---

🧰 Tech Stack

Frontend

• React.js
• HTML/CSS/JavaScript
• Axios

Backend

• Node.js
• Express.js
• dotenv
• JWT / Authentication
• Google Cloud SDK (via google-credentials.json)

---

⚙️ Setup Instructions

🛠 Prerequisites

• Node.js (v18+ recommended)
• npm (v9+)
• MongoDB (optional but common for such platforms)
• Git

---

🚀 Backend Setup

# Navigate to backend
cd backend

# Install dependencies
npm install

# Configure environment
cp .env.example .env

# Run server
npm run dev

---

💻 Frontend Setup

# Navigate to frontend
cd frontend

# Install dependencies
npm install

# Configure environment
cp .env.example .env

# Start app
npm start

---

💡 Scripts

🔧 Backend Scripts (/backend)

npm run dev       # Run with nodemon
npm start         # Run in production mode
npm test          # Run backend tests (if setup)

🎨 Frontend Scripts (/frontend)

npm start         # Start React app
npm run build     # Build production-ready app
npm test          # Run React tests

🤝 Contributing We welcome contributions!

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

Check out 'CONTRIBUTING.md' if added.

---

📄 License This project is licensed under the MIT License. See the LICENSE file for details.

---

Managed by Blink Analytics