YungR1otz/README.md

RIOTZ

Underground social/music app starter built with Flutter, Supabase, Riverpod, and go_router.

Run

flutter pub get
flutter run \
  --dart-define=SUPABASE_URL=https://YOUR_PROJECT_ID.supabase.co \
  --dart-define=SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY

Architecture

lib/
  app/
    app.dart                         # MaterialApp wiring and global shell
  core/
    config/supabase_config.dart      # Supabase bootstrap
    router/                          # Route constants + go_router config
    supabase/supabase_providers.dart # Base Supabase Riverpod providers
    theme/                           # RIOTZ dark palette and theme
  features/
    auth/presentation/providers/     # Auth state providers
    splash/presentation/pages/       # Entry page
    home/presentation/pages/         # Main starter page
  shared/widgets/riotz_shell.dart    # Reusable branded page container

Notes

• SupabaseConfig reads credentials from --dart-define values.
• Use .env.example as a template for local values.
• Use env.production.json.example as a template for release --dart-define-from-file.
• This scaffold is clean-architecture ready and feature-module friendly.
• For production Android/iOS release setup, see DEPLOYMENT.md.