Skip to content

Parth-12pm/next-stallSpot

Repository files navigation

🏢 Next StallSpot: Interactive Exhibition Management Platform

Project Banner

🌟 Project Overview

Next StallSpot is a cutting-edge web application designed to revolutionize exhibition and event space management. Our platform provides an intuitive, interactive solution for vendors, exhibitors, and organizers to manage stall bookings and floor plans with unprecedented ease.

🚀 Key Features

🗺️ Interactive 2D Floor Plan

  • Drag-and-Drop Interface: Effortlessly create and modify floor plans
  • Real-Time Visualization: See stall availability instantly
  • Responsive Design: Works seamlessly across devices

🎫 Smart Booking System

  • One-Click Stall Booking: Similar to popular ticketing platforms
  • Real-Time Availability: Know exactly what's available right now
  • Transparent Pricing: Clear pricing information at your fingertips

👥 Comprehensive User Management

  • Multi-Role Authentication:
    • Vendors: Book and manage stalls
    • Exhibitors: Organize and track events
    • Organizers: Create and manage entire exhibitions
  • Secure JWT Authentication
  • Role-Based Dashboards

🛠️ Tech Stack

Frontend Powerhouse

React Next.js TypeScript Konva

Backend Strength

Node.js Express MongoDB

🚀 Quick Start Guide

Prerequisites

  • Node.js (v18.15.0+)
  • MongoDB
  • Git

Installation Steps

# Clone the repository
git clone https://github.com/Parth-12pm/next-stallSpot.git
cd next-stallSpot

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your configuration

# Run the development server
npm run dev
```bash

## 📂 Project Structure

next-stallSpot/ ├── 🗂️ components/ # Reusable UI components ├── 📄 pages/ # Next.js route components ├── 🖼️ public/ # Static assets ├── 🎨 styles/ # Global styling ├── 🛠️ lib/ # Utilities and helpers ├── 📊 models/ # Database models └── 🔐 controllers/ # Backend route handlers


## 🤝 Contributing

We love contributions! Here's how you can help:

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (`git checkout -b feature/amazing-feature`)
3. 💾 Commit your changes (`git commit -m 'Add some amazing feature'`)
4. 📤 Push to the branch (`git push origin feature/amazing-feature`)
5. 🔀 Open a Pull Request

## 📋 License

Distributed under the MIT License. See `LICENSE` for more information.

## 📧 Contact

Project Maintainer: Parth

- GitHub: [@Parth-12pm](https://github.com/Parth-12pm)
- Email: [parthsmahadik12027@gmail.com](parthsmahadik12027@gmail.com)

---

⭐ Don't forget to star the repository if you find it helpful!