App Runbook

This is a handoff snapshot, not the product SSOT.

Product SSOT: mall-docs report-notebooklm docs, snapshot date: 2026-06-03.

Requirements

Flutter 3.44.1 / Dart 3.12.1 or compatible newer versions.
A backend API serving /api/report-notebooklm/v1.
Android SDK and accepted licenses for Android builds.
Chrome for web debug.

Check tool versions:

flutter --version
dart --version
flutter doctor -v

If dependency solving reports that Dart is older than required, switch to a Flutter SDK that includes Dart 3.12.1 or newer.

API Base URL

The App requires an explicit API base URL:

--dart-define=RNB_API_BASE=<api-base-url>

Examples:

RNB_API_BASE=http://<debug-api-host>:<port>/api/report-notebooklm/v1
RNB_API_BASE=https://<api-domain>/api/report-notebooklm/v1

Use cleartext HTTP only for local debug builds. Release builds must use HTTPS.

Web Run

flutter run -d chrome --dart-define=RNB_API_BASE=<api-base-url>

Android Emulator Run

Start the backend on the host, then:

flutter devices
flutter run -d <emulator-id> --dart-define=RNB_API_BASE=<emulator-api-base-url>

Same-Network Android Device

Start the backend on a host/port reachable from the device, then:

flutter run -d <device-id> --dart-define=RNB_API_BASE=http://<host-lan-ip>:<port>/api/report-notebooklm/v1

Use this only for debug. Do not hardcode LAN IPs in source code.

Verify

flutter analyze
flutter test
flutter build web --dart-define=RNB_API_BASE=<api-base-url>
flutter build apk --debug --dart-define=RNB_API_BASE=<emulator-api-base-url>

Release Notes

Release builds must not allow cleartext traffic.
Production API base must be passed explicitly.
Release signing is not finalized in this scaffold.
Final app icon and store metadata are not finalized.
Do not commit build outputs, APKs, screenshots, .dart_tool/, or local IDE caches.

1.9 KiB Raw Blame History