frozen-app

As a user, I want all pages of the app to share a consistent theme and color system. Create a global theme file/CSS variables with the frozen-app design tokens (primary #1A3A52, secondary #FF6F61, accent #00D9FF, highlight #FFB84D, bg #F4F9FF, surface #FFFFFF, text #1A1A1A, text_muted #A3B4C4, border rgba(163,180,196,0.2), font_family Inter). Apply theme to all existing scaffold pages (Login, Signup, Dashboard). Remove any pages not in the user flows (welcome page). Ensure consistent typography, spacing, and component styles across all pages.

As a user, I want to be able to use the backend API for rating and reviewing stories or items after purchase. Implement FastAPI endpoints for: submit review (star rating 1-5, comment text), get reviews for a listing, get average rating, flag/report a review. Endpoints: POST /reviews, GET /reviews/{listing_id}, GET /reviews/{listing_id}/average, POST /reviews/{id}/flag. Only allow reviews from verified purchasers. Store in MySQL with IST timestamps.

As a user, I want to be able to use the backend API for receiving push notifications for messages, purchases, and updates. Implement FastAPI endpoints and background task triggers for: register device token, send notification on new message, send notification on purchase/payment, send notification on new listing from followed seller. Endpoints: POST /notifications/register, POST /notifications/send (internal), GET /notifications (user inbox). Integrate with Firebase Cloud Messaging (FCM) for web and mobile push.

As a user, I want to be able to use the backend API for subscribing to premium features on frozen-app. Implement FastAPI endpoints for: create subscription plan, subscribe user to a plan, check subscription status, cancel subscription, list available plans with INR pricing. Endpoints: GET /subscriptions/plans, POST /subscriptions/subscribe, GET /subscriptions/status, POST /subscriptions/cancel. Integrate with INR payment gateway for recurring billing. Enforce feature gating for premium users (enhanced story visibility, advanced analytics).

As a user, I want to be able to use the frontend for signing in to the frozen-app. Implement the Login page with email/password fields, 'Sign In' CTA, link to Signup, and forgot password link. Apply frozen-app theme (primary #1A3A52 header, surface cards, accent buttons). Connect to existing authentication backend. Page flows from Landing NavBar 'Sign In' button and redirects to Dashboard on success. Matches design tokens and style guide.

As a user, I want to be able to use the frontend for creating a new account on frozen-app. Implement the Signup page with name, email, password fields, role selection (Writer / Buyer / Seller), and 'Create Account' CTA. Apply frozen-app theme. Page is linked from Landing 'Sign Up' button and Guest flow (Items → Signup). Redirect to Dashboard after successful registration. Matches design tokens.

As a user, I want to be able to use the frontend for browsing and searching stories and historical items. Implement the Marketplace page with: search bar with filters (genre, keywords, categories), story listings grid with cover image, title, author, price in INR, and 'View Story' CTA, and historical items grid. Supports both Buyer flow (Login → Marketplace → Story Detail) and Guest flow (Landing → Marketplace → Story Detail). Apply frozen-app theme with accent #00D9FF for search and secondary #FF6F61 for item CTAs.

As a user, I want to be able to use the frontend for chatting directly with writers, buyers, or sellers. Implement the Inbox page with: conversation list sidebar (avatar, name, last message preview), message thread view (chat bubbles, timestamps in IST), message input with send button, and unread badge counts. Page is reached after purchase (Checkout → Inbox) and from seller flow (List Item → Inbox). Apply frozen-app theme with primary #1A3A52 for header and accent #00D9FF for send button.

As a user, I want to be able to use the frontend for browsing historical items listed for sale. Implement the Items page with: items grid (image, title, price in INR, seller avatar, 'View Item' CTA), search and filter bar (category, price range), and pagination. Supports Guest flow (Landing → Items → Signup). Apply frozen-app theme with secondary #FF6F61 for item CTAs. Links to Story Detail equivalent for item detail view and Signup for guests wanting to purchase.

As a user, I want to be able to use the frontend for viewing my analytics, earnings, and activity on frozen-app. Implement the Dashboard page with: earnings summary card (INR, monthly/total), sales chart (line/bar), recent transactions table, views count, bookmarks received, and quick action buttons (Upload Story, List Item, Go to Inbox). Supports both Writer flow (Login → Dashboard → Upload Story) and Seller flow (Login → Dashboard → List Item). Apply frozen-app theme with primary #1A3A52 sidebar and surface cards.

As a user, I want to be able to use the frontend for managing my profile and listings. Implement the Profile page with: user avatar, name, bio, role badge (Writer/Seller/Buyer), listed stories grid (for writers), listed items grid (for sellers), reviews received section, and edit profile button. Page is reached from Writer flow (Upload Story → Profile: Manage Listings). Apply frozen-app theme with primary #1A3A52 profile header and surface cards for listings. Link to Upload Story and List Item CTAs.

As a user, I want to be able to use the frontend for previewing a story before purchase. Implement the Story Detail page with: story cover image, title, genre tags, author profile card, synopsis/preview excerpt, price in INR, 'Purchase Story' CTA (accent #00D9FF), bookmark button, ratings & reviews section, and 'Message Writer' link to Inbox. Page is reached from Marketplace and leads to Checkout on purchase. Supports both Buyer (full access) and Guest (preview only, blocked on purchase).

As a user, I want to be able to use the frontend for listing a historical item for sale. Implement the List Item page with: multi-image upload (drag & drop + preview), item title, description, category selector, condition, price in INR input, and 'Publish Listing' CTA. Two-step flow: Upload Images → Set Price (matches Seller user flow). Apply frozen-app theme. Page is reached from Dashboard and leads to Inbox for buyer communications. Validate image formats and size limits.

As a user, I want to be able to use the frontend for uploading and selling my movie story. Implement the Upload Story page with: story title, synopsis/full text editor (rich text), genre tags selector, cover image upload, preview toggle, subscription tier (free/premium visibility), price in INR input, and 'Publish Story' CTA. Two-step flow: Add Synopsis → Set Price (matches Writer user flow). Page is reached from Dashboard and leads to Profile for listing management. Apply frozen-app theme with accent #00D9FF for publish CTA.

As a user, I want to be able to use the frontend for securely purchasing a story or historical item. Implement the Checkout page with: order summary (item title, price in INR), payment method selection (UPI, card, net banking), escrow notice, and 'Confirm Purchase' CTA. Apply frozen-app theme with primary #1A3A52 for trust elements. Page is reached from Story Detail or Items and redirects to Inbox (message seller/writer) on success. Integrate with payment gateway supporting INR transactions.