Skip to content

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

Packages

Contributors

Languages