Project initializer (melos run init) + Flutter 3.47.5, Melos 8, native upgrades

[amaury901130]

Description

Adds a template → project lifecycle, and upgrades the toolchain and native projects. This is easiest to review commit by commit:

1. Flutter 3.41.3 → 3.47.5 (Dart 3.11.1 → 3.13.4) and dependencies.

   • Every direct dependency is at its latest version: get_it 9, go_router 18, permission_handler 13, package_info_plus 10, app_links 7, firebase_core 4, flutter_dotenv 6, flutter_lints 6.
   • Code migrations:
     • testLoad → loadFromString (flutter_dotenv 6).
     • A new transformTimeout case (dio). This was an analyzer error on main.
     • Getter types required by lints 6.
     • The cross-platform url_strategy.dart import. The web-only import doesn't compile for mobile on 3.47.
   • The codebase is reformatted in the 3.13 "tall" style.

2. Native projects.

   • Android: Gradle 9.3.1, AGP 9.1, Kotlin 2.4 and Java 17. compileSdk is 37, which permission_handler 13 requires; targetSdk stays 36.
   • iOS: deployment target 15.0. CocoaPods is replaced by Swift Package Manager (every plugin supports it), and the Flutter tool performed the UIScene migration.
   • Project identity now lives in two files: android/build.properties and ios/Flutter/AppIdentity.xcconfig.

3. Project initializer and Melos 8.

   • flutter_base.json records the state (template | initialized).
   • tool/project_init is a pure-Dart initializer: melos run init (prompts), or dart tool/project_init/bin/init.dart --name … --package-name … --bundle-id ….
     • It validates all input and plans every edit before writing anything.
     • It applies the edits atomically, with rollback.
     • It refuses to run twice.
   • Its tests initialize a copy of this repo, so template drift fails CI.
   • The Melos scripts move to Melos 8 conventions (exec, dependsOn, verify, gen:l10n).
   • CI:
     • New ci.yml: format, analyze, test and an Android build, in the template and in projects.
     • SonarQube becomes project-only. A gate job reads flutter_base.json, so it's skipped in the template and turns on after init.

4. Docs.

   • New docs/development/project-initialization.md: lifecycle, parameters, what init changes, manual steps, toolchain.
   • CLAUDE.md, README and the guides are updated.

5. Initializer fix: indirect dependency names.

   • Package names of indirect dependencies (such as bloc, reached through flutter_bloc, or meta) used to pass validation. melos bootstrap then failed, and the initializer refused to run again.
   • They are now rejected before anything is written. The names are listed in tool/project_init/lib/src/resolved_packages.dart, and a test fails when pubspec.lock gains a package the list is missing.

6. README rewrite.

   • It now covers requirements, project setup, environments, running each flavor, everyday commands, release builds, CI and contributing to the template.
   • It drops features that don't exist (the Gemini chat, RS-GPT-Review, Bitrise).

Issue

N/A

Preview

N/A (tooling / native)

Validation (local: macOS, Xcode 27, JDK 17)

• Baseline on main (Flutter 3.41.3): analyze failed, format failed (a test file from fix(common): make ResultType.mapError invoke its callback #118), and all native builds failed. The causes were Kotlin 1.8.22, iOS deployment targets below 15, and a broken include path in qa.xcconfig.
• This branch, template state:
  • melos run verify passes: format, analyze across 5 packages, 27 tests.
  • These builds pass: APK debug and release; iOS simulator; iOS release (no codesign); the dev and qa flavors; web.
• Initialized sample project ("Acme Field Notes" / acme_field_notes / com.acme.fieldnotes), in a fresh copy:
  • init ran before bootstrap, through the interactive prompts, the flags, and melos run.
  • Bootstrap and verify pass, and all builds pass.
  • The binaries report com.acme.fieldnotes(.debug/.qa) and the new name.
  • Regenerating l10n gives zero diff.
  • A re-run is refused (exit 3) and leaves the tree unchanged.
• The branch is committed in the template state.
• Not verified: the GitHub Actions workflows haven't run yet (this PR is their first run), the app wasn't launched on a device, the initializer wasn't tested on Windows, and nothing was signed.

Behavior changes to review

• The iOS Debug bundle ID was com.rs.base.debug.debug (.debug applied twice). It's now com.rs.base.debug.
• iOS no longer hardcodes version 2.0.0. The pubspec version: is the single source.
• The template display name is now "RS Base" everywhere: the Android label, the web title and the l10n appName. Before, these were flutter_base_rootstrap / "Flutter Target".
• Release APKs without key.properties are signed with the debug key instead of failing.
• run:web uses the dev entrypoint.
• The Sonar host URL comes from the SONAR_URL secret. sonar.tests lists only directories that exist.
• CI and developer machines need Android platform 37: sdkmanager "platforms;android-37.0". ci.yml installs it.
• New findings are recorded in docs/architecture/known-issues.md (Define Arch #17–Define PR template for base project. #21). Among them: firebase_core pulls the entire Firebase iOS SDK while Firebase is never initialized, and lock files aren't committed.

🤖 Generated with Claude Code