Nearby Shops is a hyperlocal fashion and clothing marketplace for Indian shoppers in cities such as Ahmedabad. It connects customers with physical clothing shops in their vicinity, letting them discover nearby shops and products, compare offers, and buy from one shop at a time with delivery to their door. The product intent is warm, human, and fast: nearby shops should feel alive and reachable, and shopping should be simple enough to complete in a few confident steps.
The audience is three active human roles: Shoppers who discover, buy, track, return, and review; Shop Owners who sell from a physical shop and prepare incoming orders for pickup; and Support Agents who resolve tickets, returns, refunds, and order issues. The marketplace is deliberately shop-centric: every order belongs to exactly one shop, and multi-shop carts are split into separate per-shop checkouts and orders.
This document is the System Requirements Document for the Nearby Shops product, covering discovery and shopping, product shopping, cart and checkout, order management, customer account, returns and customer service, communication and engagement, and support and legal surfaces.
Nearby Shops is delivered as a first-party web application with three runnable services: a shared FastAPI backend hosting all application APIs and domain modules, a MariaDB database for application-owned persistent data, and a React frontend for the user interface. The backend owns order, cart, address, return, refund, review, coupon, notification, and support-ticket state, and it verifies payments through the payment provider's callback/webhook rather than trusting the frontend redirect.
Current delivery covers the full shopper lifecycle — discovery, product browsing, cart, per-shop checkout, payment, order tracking, account, wishlist, returns, refunds, reviews, notifications, offers, coupons, help, and legal pages — plus the Shop Owner's order-preparation surface and the Support Agent's ticket-handling surface. Application-owned identity is used: Shoppers self-register and log in, while Shop Owners and Support Agents receive provisioned roles before protected work.
Removed from scope
Nearby Shops is a first-party marketplace application. All shopping, account, order, return, refund, review, notification, offer, coupon, help, and legal surfaces are owned and rendered by the application. Payment authorization is owned by the external payment provider; the application receives the provider's verified callback/webhook and only then treats a payment as successful. Shop Owners and Support Agents work inside the same application through role-restricted surfaces provisioned to them.
Identity is application-owned. A Shopper creates an account through Sign Up and returns through Login. Shop Owners and Support Agents are provisioned with their roles before reaching protected work. Public discovery surfaces (Home, Search Results, Category Page, Nearby Shops, Shop Details, Product Details, Offers & Deals, Help Center, FAQ, Legal Pages) are reachable without signing in; cart, checkout, payment, orders, account, wishlist, returns, reviews, notifications, coupons, referral, contact support, shop orders, and support tickets require an authenticated identity.
Current scope excludes live GPS tracking, delivery OTP, delivery partner live location, multi-seller combined checkout, delivery reviews, chat support, and referral launch. These remain future items and are not part of current pages or acceptance.
Discovery & Shopping
Product Shopping
Cart & Checkout
Payment
Order Management
Customer Account
Returns & Customer Service
Communication & Engagement
Support & Legal
Identity & Roles
The Shopper is the primary customer of Nearby Shops, shopping for clothing from physical shops near their location in cities such as Ahmedabad. Their product context is discovery-first: they open Home, set their location, search or browse categories, and compare nearby shops and products. Their primary goal is to find the right clothing item from a nearby shop and receive it reliably.
Their distinct responsibilities include selecting a delivery location, searching and filtering, evaluating product details (size, fabric, fit, delivery availability), managing a multi-shop cart, completing a per-shop checkout with address, delivery, payment, and review steps, tracking orders, managing their account, wishlist, addresses, and followed shops, initiating returns and exchanges, following refunds, writing product and shop reviews, reading notifications, using offers and coupons, and contacting support. Their inputs are search queries, filters, variant selections, addresses, payment methods, return reasons, and review text. They interact with Shop Owners indirectly through orders and returns, and with Support Agents through tickets. Their observable success is a confirmed order with a clear delivery estimate, a trackable status, and a resolved return or refund when needed.
The Shop Owner runs a physical clothing shop listed on Nearby Shops. Their product context is a real storefront with its own offers, policies, delivery estimate, and minimum order. Their primary goal is to receive customer orders and prepare them for pickup so that customers get their items on time.
Their distinct responsibilities include maintaining the shop's presence (cover image, logo, address, opening hours, categories, offers, return policy, delivery information), receiving incoming orders on Shop Orders, and advancing each order through preparing and ready-for-pickup stages. Their inputs are order details and preparation status. They interact with Shoppers through the orders they fulfill and with Support Agents when order issues arise. Their observable success is orders moving cleanly from confirmed to ready for pickup, reflected in the Shopper's Live Order Tracking.
The Support Agent resolves customer issues for Nearby Shops. Their product context is the support queue covering tickets, returns, refunds, and order issues. Their primary goal is to resolve each ticket accurately and keep the Shopper informed.
Their distinct responsibilities include reviewing submitted tickets with order reference, issue type, description, and images, updating ticket status, and coordinating returns and refunds. Their inputs are ticket details and order context. They interact with Shoppers through ticket responses and with Shop Owners when shop-side issues arise. Their observable success is tickets resolved with status visible to the Shopper on Contact Support and Return Details.
Muse: Haraldur Thorleifsson — big-hearted boldness for a local fashion marketplace.
Headline: Shops near you, ready to deliver.
Color tokens (light mode):
#FFF6E9 (cream)#FFFFFF#1C1A17 (ink)#E8452C (coral)#FFC531 (sunflower)#6F655BTypography:
Shape language: Chunky rounded cards with 20px radii; pill buttons; colour-blocked bands; sticker-like offer tags overlapping card corners.
Layout: Colour-blocked sections stacked in a single flow; sticky search and location bar at the top; shop cards in a two-up grid that becomes one column at 375px.
Imagery: Custom flat character and spot illustrations of shoppers and shopkeepers; bold iconography for categories; no stock photography in the hero.
Motion: Lively entrance animations with short pops on hover; cards rise 4px on hover; offer tags tilt slightly on hover.
Avoid: No gradient blobs or glass panels; no identical hover-lift card grid; no blue-indigo accent on white; no Inter, Roboto, or Poppins fonts; no stock photography in the hero.
Readability: Headlines, wordmarks, labels, numbers, cards' text and controls stay entirely inside the viewport and their container at 375px, 768px, and 1280px, wrapping or scaling to fit; no other element covers any part of them. Imagery and decoration may be cropped, bled, rotated, overlapped, or cut as the direction asks, as long as they cover no readable text or control. Scrollable rows may cross the viewport edge by design; with prefers-reduced-motion, provide a usable static arrangement.
The public entry is Home. Its hero is a coral #E8452C colour block filling the top half of the screen. A large Sora headline sits left in cream #FFF6E9: "Shops near you, ready to deliver." Below it, a cream search bar with a location selector sits as one pill. A sunflower #FFC531 band with illustrated shop fronts runs across the bottom edge, carrying the hyperlocal promise visually. The subline reads "Find local fashion shops and products in your area. Compare offers and order with ease." and the call to action is "Shop nearby".
The signature moves carry through the page: the sticky top bar pairs the location selector with the search field in one pill; shop cards carry a tilted sticker offer tag on the top-right corner; the category row uses bold illustrated icons on colour chips; and the price bands Under ₹499, ₹999, and ₹1,499 appear as three stacked colour blocks. All of this recomposes accepted Home content and controls only.
Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: layered_2d
Landing Hero Motion Brief

Find local fashion shops and products in your area. Compare offers and order with ease.
Shop nearbyAround the corner
Real stores in Ahmedabad, picked by how close they are to your doorstep.
Fresh picks from local shops near your delivery location, with the shop’s price and MRP side by side.
Offers, price cuts and festive collections from fashion shops near you.
Fresh price cuts from shops in your area, refreshed each morning.
Short-window offers — grab them while the counter is hot.
Celebration prices from nearby festive racks.
Direct offers from the shops closest to you.
Savings grouped by what you are shopping for.
Curated edits for the celebrations around the corner.
The neighbourhood favourites shoppers keep coming back to — or start with the moment you’re dressing for.
Pick a moment and we’ll gather the outfit-ready pieces from shops near you.
Shop by price
Three easy budgets, filled with pieces from shops close to you.
Sign in to see your orders, saved shops and the offers waiting at your nearby stores.

Find local fashion shops and products in your area. Compare offers and order with ease.
Shop nearbyAround the corner
Real stores in Ahmedabad, picked by how close they are to your doorstep.
Fresh picks from local shops near your delivery location, with the shop’s price and MRP side by side.
Offers, price cuts and festive collections from fashion shops near you.
Fresh price cuts from shops in your area, refreshed each morning.
Short-window offers — grab them while the counter is hot.
Celebration prices from nearby festive racks.
Direct offers from the shops closest to you.
Savings grouped by what you are shopping for.
Curated edits for the celebrations around the corner.
The neighbourhood favourites shoppers keep coming back to — or start with the moment you’re dressing for.
Pick a moment and we’ll gather the outfit-ready pieces from shops near you.
Shop by price
Three easy budgets, filled with pieces from shops close to you.
Sign in to see your orders, saved shops and the offers waiting at your nearby stores.
No comments yet. Be the first!