streetwear-thrift-smx

bySupash R

Create a modern, high-end, aesthetic e-commerce web application for an indie streetwear thrift store named "SMX Thrift" based in Belagavi, Karnataka, India. --- ### 1. Visual Design & Theme (Streetwear / Y2K / Grunge Luxury Aesthetic) - **Theme:** Deep Dark Theme (rich charcoal blacks `#0d0d0d`, zinc `#18181b`, neon acid green/volt `#ccff00` or muted chrome silver accents, crisp white typography). - **Vibe:** Urban streetwear, vintage thrift boutique, brutalist minimalism, micro-interactions, smooth hover scaling on product cards, grainy/subtle film texture overlay option. - **Typography:** Bold condensed sans-serif headers (like Syne, Clash Display, or Bebas Neue vibe) paired with clean geometric body text (Inter/Grotesk). - **Badges:** Aesthetic tags like "1 OF 1 VINTAGE", "RARE FIND", "SOLD OUT", "NEW DROP", "BELAGAVI EXCLUSIVE". --- ### 2. Dual User Modes (Customer & Admin Switcher) - Include a quick toggle in the navigation/profile (or top bar) labeled: - **"Customer Storefront"** - **"Admin Dashboard"** (Can be PIN/Password protected or direct 1-click toggle for instant demoing). --- ### 3. Customer Storefront Features - **Hero Banner:** Bold title "SMX THRIFT — BELAGAVI'S STREET ARCHIVE", animated marquee ticker ("100% AUTHENTIC THRIFT • SUSTAINABLE STREETWEAR • 1 OF 1 PIECES • BELAGAVI HAND-PICKED"), "Shop Latest Drop" CTA button. - **Product Catalog & Filters:** - Categories: Hoodies & Jackets, Vintage Tees, Baggy Denims, Y2K Tops, Accessories & Caps. - Filters: Size (S, M, L, XL, XXL), Gender/Unisex, Condition (Mint, 9/10, Distressed), Price Range, Sort by (Newest Drop, Price Low-High). - Quick Search bar with instant results. - **Product Details Modal / Page:** - Multi-image gallery with zoom/slide. - Sizing details (Chest pit-to-pit, length in inches - crucial for thrift shoppers). - Fabric & wash care tips, vintage flaws disclaimer. - "Add to Cart" and "Buy Now" button. - **Interactive Cart & Drawer:** - Slide-out cart drawer showing selected items, subtotal, discount coupon input, and checkout button. - **Checkout & Demo Payment:** - Customer information form: Full Name, Belagavi/Domestic Delivery Address, Phone Number / WhatsApp, Email, Pincode. - Delivery options: "Local Belagavi Fast Handover/Pickup" or "Standard India Post/Courier Delivery". - Payment Method: Demo Checkout (options for "Mock UPI / QR Scan", "Cash on Delivery", and "Instant Mock Card Payment" with zero real charges). - Order Confirmation screen with generated Order ID, item summary, and a direct "Contact SMX Thrift on WhatsApp" link with pre-filled order text. --- ### 4. Admin Management Panel (Stock Upload & Order Tracking) - **Real-Time Notification System:** - Whenever a customer places an order, trigger an instant notification badge and sound alert in the Admin Panel. - "New Order Received" toast popup with quick-view button. - **Order Management:** - Table of all placed orders with Order ID, Customer Name, Phone/WhatsApp, Belagavi/Shipping Address, Items, Total Amount, and Status (Pending, Confirmed, Shipped, Delivered). - One-click button to contact customer directly on WhatsApp regarding order confirmation. - **Stock & Inventory Manager (Upload New Drops):** - "Add New Thrift Item" form: - Product Title - Category & Size - Pit-to-Pit & Length measurements - Condition rating (e.g., 9/10 Vintage) - Price (INR ₹) and Original MRP / Strike-through price - Image URL or file upload preview - Stock quantity (default 1 for 1-of-1 thrift pieces) - Table to edit, toggle "Mark as Sold", or delete existing stock. --- ### 5. Local Storage & State Persistence - Use Supabase (or structured browser LocalStorage fallback) so newly uploaded items immediately appear on the storefront, and placed orders immediately reflect in the admin panel with full persistence across page refreshes. - Provide pre-populated sample aesthetic thrift items (Carhartt vintage jacket, Stussy graphic tee, vintage Levi's 501, baggy cargo pants, oversized distressed knitwear) so the store looks fully stocked on first launch.

No preview

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirements Document for SMX Thrift

1. Introduction

SMX Thrift is a modern, high-end e-commerce web application for an indie streetwear thrift store of the same name, based in Belagavi, Karnataka, India. The product presents a curated archive of one-of-one vintage streetwear pieces to style-literate shoppers and gives the store's operator a private management panel to upload new drops, track incoming orders, and contact buyers directly on WhatsApp.

The product intent is twofold. For shoppers, it is a confident, brutalist storefront that treats every garment as a tagged, quoted, one-of-one artifact — with the sizing, condition, and care detail thrift buyers actually need before committing. For the store operator, it is a lightweight back office that turns a customer order into an actionable record with a status lifecycle and a one-click WhatsApp follow-up, and that turns a new garment into a live storefront listing in a single form.

The audience is young, style-literate streetwear shoppers in Belagavi and across India, plus the single store operator ("Store Admin") who runs the archive. All payments are demo-only with zero real charges; the store is a showcase and order-capture experience, not a live payment processor.

Page 1 of 20

Success Criteria and KPIs

  • A first-time visitor can reach a product, read its measurements and condition, and place a demo order end to end without leaving the storefront flow.
  • Every newly uploaded thrift item appears on the storefront immediately and survives a page refresh.
  • Every placed order appears in the Admin Panel immediately, with a notification badge, sound alert, and "New Order Received" toast, and survives a page refresh.
  • The store launches fully stocked with the five named sample pieces so it never looks empty on first launch.
  • The Admin can move an order through Pending → Confirmed → Shipped → Delivered and reach the customer on WhatsApp in one click.
Page 2 of 20

2. System Overview

SMX Thrift is delivered as a React single-page application backed by a shared FastAPI service and a MariaDB database. The storefront and the Admin Dashboard are two modes of the same application, switched by a fixed top-bar toggle. Shoppers browse, filter, search, inspect, cart, check out with demo payment, and receive an order confirmation with a WhatsApp contact link. The Store Admin authenticates through a PIN/password gate, then manages orders (status, WhatsApp contact) and inventory (add, edit, mark sold, delete) while receiving real-time new-order alerts.

Stock and orders are application-owned durable state persisted in MariaDB, so uploads and orders survive page refreshes. The store is seeded with five sample thrift pieces on first launch. Payment is demo-only: Mock UPI/QR Scan, Cash on Delivery, and Instant Mock Card Payment, all with zero real charges. Prices are in INR ₹; delivery is either Local Belagavi Fast Handover/Pickup or Standard India Post/Courier Delivery.

Removed from scope

  • None. No concept from the authoritative requirement thread was removed.
Page 3 of 20

2a. Product Interpretation and Delivery Boundary

The storefront is public and requires no account: a visitor can browse, search, filter, inspect, cart, and check out anonymously. The Admin Dashboard is a protected, role-restricted mode reached through a PIN/password gate; the gate is a distinct access boundary that cannot itself be protected. The top-bar toggle labeled "Customer Storefront" and "Admin Dashboard" is the entry point to both modes; selecting "Admin Dashboard" while unauthenticated routes to the gate, and a successful PIN/password entry opens the dashboard.

All commerce data — items, orders, statuses — is owned and persisted by the application in MariaDB. WhatsApp contact is an outbound external destination: the product generates a pre-filled message and hands off to WhatsApp; it does not send messages itself. Payment is explicitly demo-only and never touches a real payment provider. There is no current requirement for customer accounts, order history for shoppers, or real payment settlement; those remain outside the current delivery boundary.

2c. Page Content and Component Coverage

Page 4 of 20

Customer Storefront

  • Information/state: Hero banner with the bold title "SMX THRIFT — BELAGAVI'S STREET ARCHIVE", the animated marquee ticker "100% AUTHENTIC THRIFT • SUSTAINABLE STREETWEAR • 1 OF 1 PIECES • BELAGAVI HAND-PICKED", and a "Shop Latest Drop" CTA. Featured/latest-drop product grid. Fixed top bar with the Customer Storefront / Admin Dashboard toggle and a live cart count.
  • Primary actions: Click "Shop Latest Drop" to enter the Catalog; open a product; open the cart drawer; switch to Admin Dashboard.
  • Supporting actions: Hover product cards for scaling and badge reveal.
  • Domain entities: Thrift item (title, images, category, size, condition, price, MRP, badges), cart count.
  • Component responsibilities: Hero banner, marquee ticker, product card grid with corner badge tabs, top-bar mode toggle, cart-count pill.
  • States: Loading (skeleton cards while items load); empty (no items yet — prompt to check back); success (populated grid); error (item load failure with retry); recovery (retry reloads items).

Login

  • Information/state: PIN/password entry gate for the Admin Dashboard. Anonymous entry state; no protected dashboard content is visible until credentials are accepted.
  • Primary actions: Enter PIN/password and submit.
  • Supporting actions: Return to Customer Storefront.
  • Domain entities: Admin credential (single store operator).
  • Component responsibilities: Credential input, submit control, error message region.
  • States: Loading (verifying); empty (initial form); success (redirect to Admin Dashboard); error (incorrect PIN/password, retry); recovery (re-enter credentials).
Page 5 of 20

Catalog

  • Information/state: Full product grid with category tabs (Hoodies & Jackets, Vintage Tees, Baggy Denims, Y2K Tops, Accessories & Caps), filters (Size S/M/L/XL/XXL, Gender/Unisex, Condition Mint/9-10/Distressed, Price Range), sort (Newest Drop, Price Low-High), and a quick search bar with instant results.
  • Primary actions: Apply filters, sort, search, open a product.
  • Supporting actions: Clear filters; add to cart from card.
  • Domain entities: Thrift item, filter facets, search query.
  • Component responsibilities: Category tabs, filter panel, sort control, search input with instant results, product grid, badge tabs.
  • States: Loading; empty (no matches — clear-filters prompt); success (results); error (query failure with retry); recovery (clear filters or retry).

Product Details

  • Information/state: Multi-image gallery with zoom/slide; sizing details (chest pit-to-pit and length in inches); fabric and wash care tips; vintage flaws disclaimer; price and strike-through MRP; condition rating; badges.
  • Primary actions: "Add to Cart"; "Buy Now".
  • Supporting actions: Slide/zoom gallery; open cart drawer.
  • Domain entities: Thrift item, images, measurements, care info, flaws disclaimer.
  • Component responsibilities: Gallery with zoom/slide, measurement block, care/flaws block, price block, Add to Cart and Buy Now controls.
  • States: Loading; empty (item unavailable/sold out — disabled purchase controls); success; error (item load failure with retry); recovery (retry or return to Catalog).
Page 6 of 20

Cart

  • Information/state: Slide-out drawer listing selected items, subtotal, discount coupon input, and checkout button.
  • Primary actions: Adjust/remove items; apply coupon; proceed to checkout.
  • Supporting actions: Close drawer; continue shopping.
  • Domain entities: Cart line items, subtotal, coupon.
  • Component responsibilities: Line-item list, subtotal, coupon input, checkout button.
  • States: Loading; empty (empty-cart message with continue-shopping); success (items + subtotal); error (invalid coupon message); recovery (remove coupon or correct code).

Checkout

  • Information/state: Customer information form (Full Name, Belagavi/Domestic Delivery Address, Phone Number/WhatsApp, Email, Pincode); delivery options ("Local Belagavi Fast Handover/Pickup" or "Standard India Post/Courier Delivery"); payment method (Mock UPI/QR Scan, Cash on Delivery, Instant Mock Card Payment — zero real charges); order summary.
  • Primary actions: Fill form, choose delivery, choose payment, place order.
  • Supporting actions: Return to cart.
  • Domain entities: Customer details, delivery option, payment method, order draft.
  • Component responsibilities: Customer form, delivery selector, payment selector, order summary, place-order control.
  • States: Loading (submitting); empty (no cart — redirect to Catalog); success (navigate to Order Confirmation); error (validation or submission failure with field messages); recovery (correct fields and resubmit).
Page 7 of 20

Order Confirmation

  • Information/state: Generated Order ID, item summary, and a direct "Contact SMX Thrift on WhatsApp" link with pre-filled order text.
  • Primary actions: Open the WhatsApp contact link.
  • Supporting actions: Return to storefront.
  • Domain entities: Order (ID, items, totals).
  • Component responsibilities: Order ID display, item summary, WhatsApp link with pre-filled text.
  • States: Loading; empty (order not found — return to storefront); success; error (load failure with retry); recovery (retry or return).

Admin Dashboard

  • Information/state: Protected admin mode with real-time notification badge and sound alert on new orders, and a "New Order Received" toast popup with a quick-view button; entry to Orders and Inventory.
  • Primary actions: Open quick-view of a new order; navigate to Orders or Inventory; switch to Customer Storefront.
  • Supporting actions: Dismiss toast.
  • Domain entities: Order, notification state.
  • Component responsibilities: Notification badge, sound alert trigger, toast with quick-view, navigation to Orders/Inventory, mode toggle.
  • States: Loading; empty (no orders yet); success (live counts and alerts); error (alert/load failure with retry); recovery (retry).
Page 8 of 20

Orders

  • Information/state: Table of all placed orders with Order ID, Customer Name, Phone/WhatsApp, Belagavi/Shipping Address, Items, Total Amount, and Status (Pending, Confirmed, Shipped, Delivered).
  • Primary actions: Change order status; one-click WhatsApp contact for order confirmation.
  • Supporting actions: Open order detail/quick-view.
  • Domain entities: Order, status, customer contact.
  • Component responsibilities: Order table, status control, WhatsApp contact button.
  • States: Loading; empty (no orders); success; error (load/update failure with retry); recovery (retry status change).

Inventory

  • Information/state: "Add New Thrift Item" form (Product Title, Category & Size, Pit-to-Pit & Length measurements, Condition rating, Price in INR ₹ and Original MRP strike-through price, Image URL or file upload preview, Stock quantity default 1); stock table with edit, "Mark as Sold", and delete.
  • Primary actions: Add item; edit item; toggle Mark as Sold; delete item.
  • Supporting actions: Preview uploaded image.
  • Domain entities: Thrift item, stock quantity, sold state.
  • Component responsibilities: Add-item form, image preview, stock table with row actions.
  • States: Loading; empty (no stock — prompt to add first item); success (item saved, appears on storefront); error (validation/save failure with field messages); recovery (correct and resubmit, or retry).
Page 9 of 20

3. Functional Requirements

FR-1 — Dark streetwear theme. As a Customer, I should see a deep dark theme with charcoal black #0d0d0d, zinc #18181b, neon acid green/volt #ccff00 or muted chrome silver accents, and crisp white typography, so the store reads as a high-end streetwear archive. (explicit) Acceptance: the palette is applied across storefront and admin surfaces.

FR-2 — Typography. As a Customer, I should see bold condensed sans-serif headers (Syne, Clash Display, or Bebas Neue style) paired with clean geometric body text (Inter/Grotesk). (explicit) Acceptance: headings and body use the specified type families.

FR-3 — Vibe and micro-interactions. As a Customer, I should experience urban streetwear, vintage thrift boutique, brutalist minimalism with micro-interactions, smooth hover scaling on product cards, and an optional grainy film texture overlay. (explicit) Acceptance: product cards scale smoothly on hover; the grain overlay can be toggled.

FR-4 — Badges. As a Customer, I should see aesthetic tags "1 OF 1 VINTAGE", "RARE FIND", "SOLD OUT", "NEW DROP", and "BELAGAVI EXCLUSIVE" on products. (explicit) Acceptance: badges render on applicable product cards and details.

FR-5 — Mode toggle. As a user, I should switch between "Customer Storefront" and "Admin Dashboard" via a quick toggle in the navigation/profile or top bar. (explicit) Acceptance: the toggle is present and switches modes.

Page 10 of 20

FR-6 — Admin protection. As the Store Admin, I should reach the Admin Dashboard through a PIN/password gate (or direct 1-click toggle for demoing), so the dashboard is protected. (explicit + required_inference) Acceptance: selecting Admin Dashboard while unauthenticated routes to Login; correct PIN/password opens the dashboard; incorrect entry shows an error and allows retry.

FR-7 — Hero banner. As a Customer, I should see the hero title "SMX THRIFT — BELAGAVI'S STREET ARCHIVE", an animated marquee ticker "100% AUTHENTIC THRIFT • SUSTAINABLE STREETWEAR • 1 OF 1 PIECES • BELAGAVI HAND-PICKED", and a "Shop Latest Drop" CTA. (explicit) Acceptance: all three elements render; the CTA enters the Catalog.

FR-8 — Categories. As a Customer, I should browse categories Hoodies & Jackets, Vintage Tees, Baggy Denims, Y2K Tops, and Accessories & Caps. (explicit) Acceptance: each category filters the catalog.

FR-9 — Filters and sort. As a Customer, I should filter by Size (S, M, L, XL, XXL), Gender/Unisex, Condition (Mint, 9/10, Distressed), and Price Range, and sort by Newest Drop or Price Low-High. (explicit) Acceptance: filters and sort update results.

FR-10 — Quick search. As a Customer, I should use a quick search bar that shows instant results. (explicit) Acceptance: typing returns matching items immediately.

FR-11 — Product gallery. As a Customer, I should view a multi-image gallery with zoom and slide on product details. (explicit) Acceptance: images slide and zoom.

FR-12 — Sizing details. As a Customer, I should see chest pit-to-pit and length measurements in inches. (explicit) Acceptance: both measurements display.

Page 11 of 20

FR-13 — Care and flaws. As a Customer, I should see fabric and wash care tips and a vintage flaws disclaimer. (explicit) Acceptance: both blocks display.

FR-14 — Purchase controls. As a Customer, I should use "Add to Cart" and "Buy Now" on product details. (explicit) Acceptance: Add to Cart adds the item; Buy Now proceeds toward checkout.

FR-15 — Cart drawer. As a Customer, I should open a slide-out cart drawer showing selected items, subtotal, a discount coupon input, and a checkout button. (explicit) Acceptance: the drawer slides out with all elements.

FR-16 — Checkout form. As a Customer, I should enter Full Name, Belagavi/Domestic Delivery Address, Phone Number/WhatsApp, Email, and Pincode at checkout. (explicit) Acceptance: all fields are collected and validated.

FR-17 — Delivery options. As a Customer, I should choose "Local Belagavi Fast Handover/Pickup" or "Standard India Post/Courier Delivery". (explicit) Acceptance: both options are selectable.

FR-18 — Demo payment. As a Customer, I should pay via demo checkout with Mock UPI/QR Scan, Cash on Delivery, or Instant Mock Card Payment with zero real charges. (explicit) Acceptance: all three methods are selectable and no real charge occurs.

FR-19 — Order confirmation. As a Customer, I should see an order confirmation with a generated Order ID, item summary, and a "Contact SMX Thrift on WhatsApp" link with pre-filled order text. (explicit) Acceptance: Order ID and summary display; the link opens WhatsApp with pre-filled text.

FR-20 — New-order notification. As the Store Admin, I should receive an instant notification badge and sound alert in the Admin Panel whenever a customer places an order, plus a "New Order Received" toast popup with a quick-view button. (explicit) Acceptance: badge, sound, and toast fire on new order; quick-view opens the order.

Page 12 of 20

FR-21 — Order table. As the Store Admin, I should see a table of all orders with Order ID, Customer Name, Phone/WhatsApp, Belagavi/Shipping Address, Items, Total Amount, and Status (Pending, Confirmed, Shipped, Delivered). (explicit) Acceptance: all columns render; status is changeable.

FR-22 — WhatsApp contact. As the Store Admin, I should contact a customer on WhatsApp about order confirmation with one click. (explicit) Acceptance: the button opens WhatsApp with the customer's number and a confirmation message.

FR-23 — Add item form. As the Store Admin, I should add a new thrift item with Product Title, Category & Size, Pit-to-Pit & Length measurements, Condition rating, Price (INR ₹) and Original MRP strike-through price, Image URL or file upload preview, and Stock quantity (default 1). (explicit) Acceptance: the form saves and the item appears on the storefront.

FR-24 — Stock table actions. As the Store Admin, I should edit items, toggle "Mark as Sold", and delete stock from the stock table. (explicit) Acceptance: each action updates the item and storefront.

FR-25 — Persistence. As a user, I should see newly uploaded items on the storefront and placed orders in the admin panel, persisted across page refreshes. (explicit + required_inference) Acceptance: state survives refresh via MariaDB.

FR-26 — Sample items. As a Customer, I should see pre-populated sample thrift items (Carhartt vintage jacket, Stussy graphic tee, vintage Levi's 501, baggy cargo pants, oversized distressed knitwear) on first launch. (explicit) Acceptance: all five appear seeded.

4. User Personas

Page 13 of 20

Customer

The Customer is a young, style-literate streetwear shopper in Belagavi or elsewhere in India who values one-of-one vintage pieces and needs precise sizing and condition detail before buying. Primary goal: find a piece that fits, understand its measurements and flaws, and place a demo order with confidence. Distinct responsibilities: browse and filter the catalog, inspect measurements/care/flaws, cart items, apply coupons, complete checkout with demo payment, and receive an order confirmation with a WhatsApp link. Inputs/decisions: size, condition, price, delivery option, payment method. Interactions: hands off to the Store Admin via the order and WhatsApp. Observable success: an Order ID and item summary on confirmation, with a working WhatsApp contact link.

Store Admin

The Store Admin is the single operator of the SMX Thrift archive. Primary goal: keep the storefront stocked with accurate one-of-one listings and process incoming orders promptly. Distinct responsibilities: authenticate through the PIN/password gate, upload new thrift items, edit/mark-sold/delete stock, monitor new-order alerts, update order status, and contact customers on WhatsApp. Inputs/decisions: item details, stock quantity, order status transitions. Interactions: receives orders from Customers and reaches them on WhatsApp. Observable success: new items live on the storefront, orders tracked through Delivered, and customers contacted in one click.

5. Core User Flows

Page 14 of 20

Flow A — Customer browses and buys (Customer)

  1. Customer lands on Customer Storefront; sees hero title, marquee ticker, and "Shop Latest Drop".
  2. Clicks "Shop Latest Drop" → Catalog.
  3. Applies category, size, condition, price filters and sort; uses quick search for instant results.
  4. Opens a product → Product Details; slides/zooms gallery, reads pit-to-pit and length, care tips, flaws disclaimer.
  5. Clicks "Add to Cart" (or "Buy Now") → Cart drawer opens showing items, subtotal, coupon input, checkout button.
  6. Optionally applies a coupon; clicks checkout → Checkout.
  7. Fills Full Name, address, Phone/WhatsApp, Email, Pincode; selects delivery (Local Belagavi Pickup or Standard India Post/Courier); selects demo payment (Mock UPI/QR, COD, or Mock Card).
  8. Places order → Order Confirmation shows generated Order ID, item summary, and "Contact SMX Thrift on WhatsApp" link with pre-filled text.
  9. Failure/recovery: invalid form fields show messages and allow correction; submission failure allows retry. Continuation: Customer may open the WhatsApp link to reach the store.
Page 15 of 20

Flow B — Store Admin authenticates and manages orders (Store Admin)

  1. Store Admin selects "Admin Dashboard" in the top-bar toggle → Login.
  2. Enters PIN/password; on success → Admin Dashboard.
  3. On a new customer order, the dashboard fires a notification badge, sound alert, and "New Order Received" toast with quick-view.
  4. Opens quick-view or navigates to Orders; reviews Order ID, Customer Name, Phone/WhatsApp, address, Items, Total, Status.
  5. Updates status (Pending → Confirmed → Shipped → Delivered).
  6. Clicks one-click WhatsApp to contact the customer about confirmation.
  7. Failure/recovery: incorrect PIN shows error and allows retry; status update failure allows retry.

Flow C — Store Admin uploads and manages stock (Store Admin)

  1. From Admin Dashboard, Store Admin opens Inventory.
  2. Fills "Add New Thrift Item": Title, Category & Size, Pit-to-Pit & Length, Condition, Price ₹ and MRP strike-through, Image URL/file preview, Stock quantity (default 1).
  3. Saves → item appears immediately on Customer Storefront.
  4. Edits, toggles "Mark as Sold", or deletes items from the stock table.
  5. Failure/recovery: validation errors show field messages and allow correction. Continuation: changes persist across refresh.
Page 16 of 20

6. Visuals Colors and Theme

Muse: Virgil Abloh — label-and-tag language for a thrift archive. Headline: "Remixed familiarity for a Belagavi street archive."

  • Background: #0d0d0d (charcoal, ~70% of page)
  • Surface: #18181b (zinc panels)
  • Text: #fafafa (crisp white)
  • Primary: #ccff00 (volt — CTAs, badges, rules, ~10%)
  • Accent: #c8c8c0 (chrome silver)
  • Muted: #8a8a82
  • Headings font: Anton, all caps, tight tracking, oversized, stacked in quotation marks.
  • Body font: Space Grotesk Medium, sentence case.
  • Type scale: 128/72/40/24/17/14 modular (1.333); tabular numerals for prices and measurements.
  • Shape: Hard edges, hairline 1px borders, hazard-stripe bands, label tabs; no soft shadows.
  • Layout: Asymmetric 12-column grid; fixed top bar with storefront/admin toggle; dense 3-up product grid desktop, 1-up mobile; corner badge tabs.
  • Imagery: Garment photography on concrete/corrugated metal with hard flash; macro detail of care label/stitching.
Page 17 of 20

7. Signature Design Concept

The public entry is a full-bleed charcoal stage. The headline "SMX Thrift — Belagavi's Street Archive" is set in Anton at clamp(44px, 9vw, 128px), stacked in three lines and wrapped in oversized quotation marks that act as a graphic frame. A volt hazard-stripe band runs edge to edge under the headline. The "Shop Latest Drop" CTA is a solid volt rectangle pinned at the left baseline, and a small chrome tag reads "BELAGAVI EXCLUSIVE". The exact marquee copy runs in all caps with volt bullets between phrases. Every product card carries a rotated corner tag ("1 OF 1 VINTAGE", "SOLD OUT", etc.), and the fixed top bar pairs the storefront/admin toggle with a live cart count in a tag-style pill.

8. Interaction Model & Motion Direction

Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: flat

Landing Hero Motion Brief: Focal subject is the stacked Anton headline inside quotation marks over the charcoal stage. Input→transformation→outcome: on load, the headline settles into place and the volt hazard-stripe band draws across; the marquee ticker scrolls continuously; hovering a product card snaps a volt tag into view and scales the card. Motion vocabulary: 140ms transitions, no bounce, marquee tickers in hero and above footer. Composed first frame: headline, stripe band, CTA, chrome tag, and ticker all visible. Reduced-motion state: ticker wraps into static rows and all items remain fully readable; hover scaling is disabled.

Page 18 of 20

9. Non-Functional Requirements

  • NFR-1 (explicit): Payment is demo only — Mock UPI/QR Scan, Cash on Delivery, Instant Mock Card Payment — with zero real charges.
  • NFR-2 (explicit): Stock quantity defaults to 1 for 1-of-1 thrift pieces.
  • NFR-3 (explicit): Store is based in Belagavi, Karnataka, India; prices in INR ₹.
  • NFR-4 (explicit): Admin Dashboard is PIN/password protected or a direct 1-click toggle for demoing.
  • NFR-5 (required_inference): Stock and orders persist durably across page refreshes (MariaDB).
  • NFR-6 (explicit): Newly uploaded items appear immediately on the storefront; placed orders appear immediately in the admin panel.
  • NFR-7 (explicit): Readable text and controls stay whole at 375px, 768px, and 1280px; marquees may cross edges but every item becomes fully readable as it passes; reduced-motion provides a usable static arrangement.

10. Tech Stack

  • Frontend: React single-page application.
  • Backend: Shared FastAPI process for application APIs and domain modules (items, orders, notifications).
  • Database: MariaDB for application-owned persistent data (items, orders, statuses, seed data).
  • Persistence: Supabase or structured browser LocalStorage fallback is the source-stated option; the provisioned MariaDB backend is the authoritative durable store for this delivery.
  • Deployment: docker-compose with backend, database, and frontend services.
Page 19 of 20

11. Assumptions and Constraints

  • A-1: A single Store Admin operates the dashboard; the PIN/password gate protects one operator credential. (required_inference)
  • A-2: WhatsApp contact is an outbound handoff via link with pre-filled text; the product does not send messages itself. (explicit)
  • A-3: Payment is demo-only; no real payment provider is integrated. (explicit)
  • A-4: Customers check out anonymously; no customer account is required. (required_inference)
  • A-5: The five named sample items are seeded on first launch. (explicit)
  • A-6: MariaDB is the durable store; LocalStorage fallback is not the primary persistence for this delivery. (required_inference)

12. Glossary

  • Thrift item: A one-of-one vintage garment listed for sale.
  • Pit-to-pit: Chest measurement across the garment in inches.
  • MRP: Original maximum retail price shown as a strike-through.
  • Demo payment: Mock UPI/QR, COD, or Mock Card with zero real charges.
  • Drop: A batch of newly uploaded thrift items.
  • Mode toggle: Top-bar switch between Customer Storefront and Admin Dashboard.
  • Order status: Pending, Confirmed, Shipped, Delivered.
Page 20 of 20

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

Customer Storefront: 1. View hero and latest drop
Catalog: 2. Shop latest drop
Catalog: 3. Apply filters and sort
Catalog: 4. Search for items
Catalog: 5. Clear filters for no matches
Product Details: 6. Open a product
Product Details: 7. Slide and zoom gallery
Product Details: 8. Read measurements and flaws
Product Details: 9. Retry item load failure
Cart: 10. Add item to cart
Cart: 11. Apply discount coupon
Cart: 12. Correct invalid coupon
Cart: 13. Remove item and continue shopping
Checkout: 14. Proceed to checkout
Checkout: 15. Fill customer details
Checkout: 16. Choose delivery option
Checkout: 17. Choose demo payment method
Checkout: 18. Correct validation errors
Checkout: 19. Place order
Order Confirmation: 20. View order ID and summary
Order Confirmation: Open WhatsApp contact link
Order Confirmation: 21. Return to storefront

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

Customer Storefront: 1. View hero and latest drop
Catalog: 2. Shop latest drop
Catalog: 3. Apply filters and sort
Catalog: 4. Search for items
Catalog: 5. Clear filters for no matches
Product Details: 6. Open a product
Product Details: 7. Slide and zoom gallery
Product Details: 8. Read measurements and flaws
Product Details: 9. Retry item load failure
Cart: 10. Add item to cart
Cart: 11. Apply discount coupon
Cart: 12. Correct invalid coupon
Cart: 13. Remove item and continue shopping
Checkout: 14. Proceed to checkout
Checkout: 15. Fill customer details
Checkout: 16. Choose delivery option
Checkout: 17. Choose demo payment method
Checkout: 18. Correct validation errors
Checkout: 19. Place order
Order Confirmation: 20. View order ID and summary
Order Confirmation: Open WhatsApp contact link
Order Confirmation: 21. Return to storefront