diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0ab4c4e..947f0fb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -21,6 +21,7 @@ Thanks for contributing to car64.
 ```bash
 flutter pub get
 flutter analyze
+flutter run --dart-define-from-file=.env/flutter_defines.json
 ```
 
 ## Code Style
diff --git a/README.md b/README.md
index 1db737a..48ba972 100644
--- a/README.md
+++ b/README.md
@@ -101,7 +101,7 @@ flutter analyze
 3. Launch app
 
 ```bash
-flutter run
+flutter run --dart-define-from-file=.env/flutter_defines.json
 ```
 
 ## VS Code Workflows
@@ -125,6 +125,10 @@ Use **Terminal → Run Task**:
 - `Flutter Build APK (Release)`
 - `Flutter Build App Bundle (Release)`
 - `Flutter Build iOS IPA (Release)`
+- `Flutter Build All Release (Parallel)`
+- `Package Release Artifacts (Explicit Label)`
+- `Build Android + Package Release (Prompt)`
+- `Flutter Run Android (Supabase Debug - Auto Device)`
 
 Task definition file: [.vscode/tasks.json](.vscode/tasks.json)
 
@@ -163,15 +167,12 @@ Task definition file: [.vscode/tasks.json](.vscode/tasks.json)
 - [ ] Manual smoke test on iOS
 - [ ] Confirm `.env/flutter_defines.json` points to production Supabase
 - [ ] Build Android `appbundle`
+- [ ] Build Android `apk`
 - [ ] Build iOS `ipa`
+- [ ] Package artifacts with `bash tool/package_release.sh <release-label>`
+- [ ] Verify `SHA256SUMS.txt` and `MANIFEST.md` in `release/<release-label>/`
 - [ ] Verify auth, scan flow, collections, and upload flows
 
-## Roadmap
-
-- [ ] Optional dark/light theme toggle in settings
-- [ ] Extended scanner confidence hints and retry UX
-- [ ] Bulk actions and better collection analytics
-- [ ] Improved offline behavior for low-connectivity sessions
 
 ## Contributing