Neo-Marketplace 🚀

A high-performance, cinematic e-commerce platform built with Flutter and Supabase. Neo-Marketplace combines modern Glassmorphism design with a production-grade secure payment architecture using Stripe and Supabase Edge Functions.

---

What the project does

Neo-Marketplace is a comprehensive shopping application that bridge the gap between concept and production. It allows users to browse products, manage a real-time cart, handle favorites, and perform secure checkouts.

Key Features

• Cinematic UI: Custom Glassmorphism containers, 3D neumorphic buttons, and fluid Hero animations.
• Secure Payments: Server-side Payment Intent creation via Deno Edge Functions to keep Stripe keys hidden.
• Auth Flow: Supabase-powered OTP verification with custom-designed curved UI headers.
• Dynamic Content: Real-time category filtering and global debounced search.
• Order Lifecycle: Automated order creation, atomic cart clearing, and detailed transaction history.
• Robust Architecture: Built with Riverpod for state management and GoRouter for deep-linked navigation.

---

📸 Screenshots

Client Interface

Home Screen	Product Catalog	Product Details	Advanced Filtering

Shopping Cart	Checkout	Secure Payment	Order Success

Profile & Settings	Notifications	Live Chat	Biometric Security

Admin Panel

Dashboard	Product Management	Order Management

---

Getting Started

Prerequisites

• Flutter SDK (v3.9.0+)
• Supabase CLI
• A Stripe account (Sandbox/Test mode)

1. Supabase Initialization

1. Create a new Supabase project.
2. Run the SQL initialization scripts located in the root directory:
   • schema.sql (Core tables)
   • user_profiles.sql (Extended user data)
   • orders.sql (Order & Tracking tables)
   • favorites.sql (User favorites)
3. Set your Supabase URL and Anon Key in lib/core/config/supabase_config.dart.

2. Secure Stripe Setup

1. Deploy the Edge Function for Payment Intents:

   npx supabase functions deploy create-payment-intent --no-verify-jwt

2. Set your Stripe Secret Key in Supabase environment secrets:

   npx supabase secrets set STRIPE_SECRET_KEY=sk_test_...

3. Update the Publishable Key in lib/main.dart's StripeService.init() call.

3. Running the App

flutter pub get
flutter run

4. Updating Branding (Icons)

If you change the source image at assets/images/app_icon.png, run:

dart run flutter_launcher_icons:main

---

Project Structure

neo_market/
├── lib/
│   ├── core/           # Routing, Theme, Configuration, Services
│   ├── features/       # Feature-based architecture (Home, Cart, Profile, Auth)
│   ├── models/         # Cross-feature data models
│   └── main.dart       # Entry point & SDK initialization
├── supabase/
│   └── functions/      # Serverless logic (Deno)
└── assets/
    ├── icons/          # Custom SVG icons
    └── images/         # Premium illustrations

---

Technical Requirements

• Android: Requires minSdk 21 and compileSdk 36 (due to Stripe and modern plugin requirements).
• Security: The app utilizes Row Level Security (RLS) in Supabase to ensure users can only access their own orders and profile data.

---

Contribute & Support

Where to get help

• For Stripe integration issues, refer to the Stripe Documentation.
• For Supabase backend assistance, check out the Supabase Guides.

How to contribute

Contributions make the local community great!

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

---

Maintainers

• Primary Maintainer: Tsinat Kibru

---

License: Project is intended for internal use and demonstration purposes. Reference LICENSE if applicable.