Bhubaneswar Market Plex: A Hyperlocal Digital Marketplace Platform

Abstract

Bhubaneswar Market Plex is a full-stack, hyperlocal digital marketplace platform specifically designed to serve the
commerce needs of the residents of Bhubaneswar, Odisha. The platform addresses a significant gap in the digital
commerce ecosystem of Tier-2 Indian cities: the absence of a single unified application that integrates three distinct
commerce modes — a second-hand goods marketplace, a quick commerce grocery delivery service, and a fullfeatured
e-commerce catalog — in a locally relevant context.
The rapid growth of India's digital economy has created strong demand for hyperlocal commerce platforms, yet
large national platforms like Amazon, Flipkart, OLX, and Blinkit fail to reflect the specific geography, trade culture,
and neighbourhood trust networks of individual cities like Bhubaneswar. This project is conceived to digitise and
streamline all three commerce modes in one application, rooted in the geography and economy of Bhubaneswar with
real locality names, local store profiles, and a trust-first marketplace design.
The platform supports three user roles: Buyer, Seller, and Administrator, each with role-appropriate access enforced
via JSON Web Tokens (JWT) and bcrypt-hashed passwords. The Marketplace module provides OLX-style
classified listings with condition grading (New, Like New, Good, Fair, Poor), price negotiation flags, and an
administrator moderation queue that ensures all listings are reviewed before going live. The Quick Commerce
module connects buyers with local Bhubaneswar grocery and essentials stores for fast delivery. The E-Commerce
module provides a full product catalog with cart, wishlist, order management, star-rated reviews, and a flash sale
system with countdown timers.
The platform is built using a modern, production-grade technology stack: React 18 with TypeScript for the frontend,
Express 5 on Node.js 24 for the backend, PostgreSQL as the relational database accessed through Drizzle ORM, and
TanStack React Query for server state management. The project is structured as a pnpm monorepo with seven
shared workspace packages. An OpenAPI 3.0 specification serves as the authoritative API contract from which both
React Query hooks and Zod validation schemas are auto-generated using Orval, ensuring end-to-end type safety
across the entire application.
The database comprises ten relational tables supporting all commerce modules, user roles, order management, cart,
wishlist, reviews, and promotional banners. The backend exposes fourteen API route groups with over sixty
endpoints, and the frontend implements twenty-one screens including a comprehensive Admin Panel. The
application demonstrates sound software engineering practices including monorepo architecture, contract-first API
design, end-to-end TypeScript type safety, role-based access control, rate-limited authentication, and responsive UI
design with Framer Motion animations.
Testing of the platform confirms that all security scenarios, functional requirements, and responsive design
breakpoints are met. The system successfully processes user registration, authentication, product browsing, cart
management, order placement and lifecycle tracking, marketplace listing with admin moderation, and full
administrator CRUD operations. The platform represents a complete, locally relevant digital commerce solution for
Bhubaneswar and a strong demonstration of modern full-stack web development practices at the undergraduate
level.