🚧 Currently in active development – contributions and feedback are welcome!
Next StallSpot is a powerful and user-friendly web platform built to streamline stall booking and exhibition space management. Designed for organizers, vendors, and exhibitors, this platform combines real-time interaction with a modern tech stack to make managing exhibitions a breeze.
Whether you're booking a stall, planning an entire event, or monitoring exhibitor activity, Next StallSpot simplifies it all.
- 🔄 Real-Time Stall Availability – Instantly see which stalls are booked or available.
- ⚡ One-Click Booking – Just like ticketing apps; reserve stalls in seconds.
- 💰 Transparent Pricing – Know exactly what you pay, no hidden fees.
- Vendor Dashboard – View & manage stall bookings.
- Exhibitor Dashboard – Coordinate with vendors and monitor event flow.
- Organizer Dashboard – Design stall layouts, approve bookings, manage revenue.
- 🔐 Secure JWT-Based Authentication
- ⚙️ Role-based Access Controls
| Tech | Description |
|---|---|
| Next.js | SSR support with React framework |
| TypeScript | Type-safe, robust front-end code |
| Konva.js | Interactive floor plan canvas rendering |
Badges:
| Tech | Description |
|---|---|
| Node.js | Backend runtime environment |
| Express.js | API and server logic handling |
| MongoDB (Atlas) | NoSQL database for stall data |
Badges:
Ensure the following are installed:
- Node.js (v18.15.0+)
- MongoDB Atlas or Local Mongo
- Git
# 1. Clone the repository
git clone https://github.com/Parth-12pm/next-stallSpot.git
cd next-stallSpot
# 2. Install dependencies
npm install
# 3. Create environment config
cp .env.example .env.local
# 4. Update .env.local with your credentials
# 5. Run the development server
npm run dev
---
📁 Project Structure
next-stallSpot/
├── components/ # Reusable UI components
├── pages/ # Next.js route handlers
├── public/ # Static assets
├── styles/ # CSS & Tailwind styles
├── lib/ # Helper functions, APIs
├── models/ # Mongoose schemas
└── controllers/ # Server-side logic & routes
---
🔐 Environment Variables Setup
To run locally, configure the following in .env.local:
> Refer to the Environment Setup Guide for full details.
MongoDB
MONGODB_URI=
NextAuth
NEXTAUTH_SECRET=
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_PUBLIC_URL=http://localhost:3000
Cloudinary (Media Uploads)
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
Razorpay (Payments)
RAZORPAY_KEY_ID=
RAZORPAY_KEY_SECRET=
NEXT_PUBLIC_RAZORPAY_KEY_ID=
Nodemailer SMTP (Email via Gmail)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=true
SMTP_USER=
SMTP_PASS=
---
🤝 Contributing
We welcome all kinds of contributions – bug reports, feature suggestions, code improvements.
How to contribute:
1. 🍴 Fork the repository
2. 🌱 Create a feature branch
git checkout -b feature/your-feature-name
3. ✅ Make your changes & commit
git commit -m "Add your message"
4. 🚀 Push your branch
git push origin feature/your-feature-name
5. 🔃 Create a Pull Request on GitHub
---
📧 Contact
Maintained by Parth Mahadik
GitHub: @Parth-12pm
Email: [email protected]
---
⭐ If you like this project, don’t forget to star it on GitHub!
---