hwhub/README.md

1.2 KiB

car64

car64 is a Flutter + Supabase Hot Wheels collector app with a fast scanning workflow, private photo storage, collaborative collections, and community-based catalog validation.

Core Features

  • Lightning add flow with barcode/OCR scanning and active collection selection.
  • Global catalog (global_cars) + personal entries (hotwheels) architecture.
  • Private storage (car-images) with signed URL rendering for collection members.
  • In-app photo compression pipeline (target max 1080px and <500 KB uploads).
  • Collaborative garages via collections + collection_members.
  • Community validation with car_votes, confirmation_count, and verification state.

Local Development

  1. Install Flutter (stable) and run flutter doctor.

  2. Configure Supabase values via build-time variables (--dart-define), for example:

    flutter run \
      --dart-define=SUPABASE_URL=https://your-project.supabase.co \
      --dart-define=SUPABASE_ANON_KEY=your_anon_key \
      --dart-define=SUPABASE_USE_PKCE=true
    
  3. Install dependencies:

    flutter pub get
    
  4. Run the app:

    flutter run
    

Quality Check

flutter analyze

Reference

  • Product and backend requirements: TPB.md