Skip to content

Nir-Bhay/Seatwise

Repository files navigation

Seatwise Logo

🎓 SeatWise

Intelligent Exam Hall Seating Arrangement System

License: MIT Status Version Made with Love

FeaturesTech StackGetting StartedStructureRoadmap


🚀 Overview

SeatWise is a modern, AI-powered web examination management system designed to streamline the complex process of exam hall seating arrangements. It transforms chaotic manual scheduling into an organized, efficient, and error-free digital workflow.

Newly Redesigned: Now featuring a premium Dark Glassmorphism UI/UX for a futuristic and professional experience.


✨ Features

Feature Description
🤖 Intelligent AI Allocation Algorithms that automatically distribute students to ensure fairness and prevent cheating.
📊 Excel Integration Seamlessly import student data and export seating charts using SheetJS.
📄 PDF Generation Generate professional, printable seating plans and attendance sheets with jsPDF.
🎨 Modern UI/UX A stunning Dark Glassmorphism interface with smooth animations and responsive design.
📱 Mobile Responsive Fully accessible on all devices, from desktops to mobile phones.
⚡ Real-time Stats Live dashboard showing student counts, room allocation, and efficiency metrics.

🛠 Tech Stack

Core Styling Logic Libraries
HTML5 CSS3 JavaScript SheetJS
Semantic Markup Glassmorphism ES6+ Features jsPDF / RemixIcon

🏁 Getting Started

Follow these steps to set up the project locally.

Prerequisites

  • A modern web browser (Chrome, Firefox, Edge)
  • Node.js (optional, for development server)

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/Seatwise.git
    cd Seatwise
  2. Run the project

    • Option A (Simple): Open index.html directly in your browser.
    • Option B (Developer): Use a local server for best performance.
      npx http-server . -p 8080
  3. Access the App Open http://localhost:8080 in your browser.


📂 Project Structure

Seatwise/
├── 📄 index.html          # Landing Page (Redesigned)
├── 📄 auth.html           # Authentication / Login Page
├── 📄 app.js              # Main Application Logic
├── 📄 script.js           # UI Interactions & Animations
├── 📄 style.css           # Global Styles (Dark Theme)
├── 📂 Image/              # Assets & Icons
├── 📂 docs/               # Documentation & Audit Reports
│   └── 📂 audit-reports/  # System Analysis
├── 📂 marge/              # Excel Merging Tool
├── 📂 pdf/                # Generated PDF Output Examples
└── 📂 .agent/             # AI Agent Config & Skills

🗺 Roadmap

  • Phase 1: UI Redesign - Dark Glassmorphism Theme
  • Phase 2: Code Cleanup - Removal of legacy files
  • Phase 3: Backend Integration - Cloud database support
  • Phase 4: Advanced AI - Smart shuffling algorithms

🤝 Contributing

Contributions are always welcome! Please check out our contribution guidelines first.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Made with ❤️ by Dipu Kumar

LinkedIn GitHub

About

Simplifying and automating the process of organizing exams with efficient seating plans, schedules, and student data management.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors