ShopLaunch - Flutter Supabase E-Commerce Kit

ShopLaunch is a rebrandable Flutter e-commerce starter kit for developers and small commerce teams. It includes a responsive customer storefront for Android, iOS and Web, a Flutter Web administration panel, shared Dart commerce logic, and a Supabase backend foundation.

Start immediately in the included no-account Demo mode, or connect the apps to a Supabase project owned and controlled by the buyer. The package includes organized source code, repeatable demo data, database migrations, row-level security, checkout and inventory logic, automated tests, and complete English offline documentation.

CUSTOMER STOREFRONT

- Android, iOS and Web Flutter targets

- Responsive home, catalog, search and category filtering

- Product details, variants, inventory, favorites and cart

- Address management, coupons, shipping calculation and checkout quote

- Order history, account flows, light/dark theme and bilingual UI

- Traditional Chinese and English interface

ADMINISTRATION PANEL

- Responsive Flutter Web layout

- Dashboard with clearly labelled demonstration metrics

- Product, price, stock and publish-state controls

- Category/banner, order, coupon, review and store-setting screens

- Supabase admin role check and audit display

SUPABASE BACKEND FOUNDATION

- PostgreSQL schema, migrations and repeatable seed

- Row-level security policies and admin authorization helpers

- Transactional checkout RPC with inventory locking and idempotency

- Coupon validation and cancellation/expiry resource restoration

- Reviews, notification data model and database test script

- Demo payment and delete-account Edge Functions

PACKAGE CONTENTS

- Full customer Flutter app source

- Full Flutter Web admin source

- Shared Dart commerce package

- Supabase migrations, seed, configuration, tests and Edge Functions

- Original geometric demo product illustrations

- Lockfiles, configuration examples, automated tests and English documentation

IMPORTANT PRODUCTION BOUNDARIES

The included checkout is a clearly labelled demonstration and never performs a real charge. A live payment gateway, carrier/shipping API, transactional email, native push delivery, hosted demo, app-store accounts, signing credentials and third-party subscriptions are not included. Buyers must create and configure their own Supabase project and required third-party accounts.

No app-store approval, marketplace approval, revenue or business outcome is promised. Some administration sections are demonstration UI/session state; the documentation identifies connected Supabase operations and remaining production work.

SUPPORT

Support follows Codester's standard support policy. It covers questions and reproducible defects in the unmodified item for up to 12 months after purchase. Installation, environment configuration, third-party software, custom features, deployment and app-store submission are not included.

Features

- Customer Flutter app for Android, iOS and Web

- Responsive Flutter Web administration panel

- Shared Dart commerce models and integer-money calculations

- No-account Demo mode with repeatable demo data

- Buyer-owned Supabase connected mode

- PostgreSQL migrations, seed, RLS policies and RPCs

- Atomic checkout, inventory locking and idempotent order creation

- Product variants, stock, favorites, cart, addresses and coupons

- Order history, reviews and notification data model

- Traditional Chinese and English interface

- Light and dark themes

- Original redistributable geometric demo illustrations

- Automated unit, widget and responsive-layout tests

- Complete English installation, configuration and rebranding documents

- Exact Android/iOS icon and splash asset paths

- Android keystore and iOS release-signing instructions

- Demo payment disclosure: no real charge is performed

Requirements

- Flutter 3.41.9 stable and Dart 3.11.5 (verified release environment)

- Chrome for Web development

- Android Studio, Android SDK and Java 17 for Android builds

- macOS, Xcode and CocoaPods for iOS builds

- Buyer-owned Apple Developer account for signed iOS releases

- Buyer-owned Supabase project and Supabase CLI for connected mode

- Buyer-owned signing keys, app-store accounts and third-party service accounts

- Production payment, shipping, email and push providers are not included

Instructions

1. Extract ShopLaunch-1.0.2.zip.

2. Read README.md and docs/QUICKSTART.md.

3. Run flutter pub get in packages/shoplaunch_core, apps/storefront and apps/admin.

4. Start the storefront or admin with APP_MODE=demo; Demo mode needs no account or key.

5. To use connected mode, create a buyer-owned Supabase project and follow docs/SUPABASE_SETUP.md, docs/AUTH_SETUP.md and docs/SECURITY.md.

6. Apply the supplied migrations and repeatable seed, then configure the buyer's public Supabase URL and publishable/anon key through dart-define values. Never put a service-role key in a client build.

7. Follow docs/BRANDING.md and docs/MOBILE_RESKIN_AND_SIGNED_RELEASE.md before publishing.

8. The mobile guide lists every Android/iOS icon and splash path, package/bundle identifier change, Android key.properties setup, Apple team/provisioning setup, signed build command, output path and signature verification command.

9. Run the included test matrix and complete docs/DELIVERY_CHECKLIST.md before production.

10. Integrate buyer-selected live payment, shipping, email and push services before claiming production readiness.