first commit

README.md

@@ -0,0 +1,38 @@
+# RIOTZ
+
+Underground social/music app starter built with Flutter, Supabase, Riverpod, and `go_router`.
+
+## Run
+
+```bash
+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
+
+```text
+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`.