chore(release): 0.0.1-alpha.9 (#20)

* chore(release): 0.0.1-alpha.9

* docs: fix Gate ability names in profile.md, add HideBottomNav to widgets table

- profile.md: replace incorrect dot-notation Gate ability names
  (starter.profile.*) with actual hyphenated names from service provider
  (starter.update-*, starter.manage-*, starter.verify-*, etc.)
- views-and-layouts.md: add MagicStarterHideBottomNav to the Other
  Exported Widgets table

Author: anilcancakir

CHANGELOG.md

@@ -4,9 +4,19 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
-### Added
-- Documentation for recommended state/controller registration pattern for consumer apps (`doc/architecture/controllers.md`, `doc/guides/state-management.md`)
-- State registration guidance in scaffolded `app_service_provider.stub`
+## [0.0.1-alpha.9] - 2026-04-04
+
+### ✨ New Features
+- **MagicStarterHideBottomNav**: New `InheritedWidget` that signals `MagicStarterAppLayout` to hide the mobile bottom navigation bar for fullscreen routes — wired into layout and exported from barrel (#19)
+
+### 📚 Documentation
+- **State/Controller Registration Guide**: New architecture reference (`doc/architecture/controllers.md`) covering the lazy singleton pattern, `MagicController + MagicStateMixin` usage, controller lifecycle, view binding, and a decision tree for eager vs lazy vs per-view registration (#18)
+- **State Management Getting-Started Guide**: New practical guide (`doc/guides/state-management.md`) with end-to-end examples — state class, view integration, and testing patterns for consumer apps (#18)
+- **Scaffolded Stub**: `app_service_provider.stub` now includes state registration guidance comments showing the recommended `Magic.findOrPut()` pattern (#18)
+- **Cross-References**: `doc/architecture/service-provider.md` now links to the new controllers doc (#18)
+
+### 🔧 Improvements
+- **CI**: Bumped `codecov/codecov-action` from v5 to v6 (#16)
 
 ## [0.0.1-alpha.8] - 2026-03-31
 

CLAUDE.md

@@ -2,7 +2,7 @@
 
 Flutter starter kit for the Magic Framework. Pre-built Auth, Profile, Teams & Notifications — 13 opt-in features, every screen overridable via Wind UI.
 
-**Version:** 0.0.1-alpha.8 · **Dart:** >=3.6.0 · **Flutter:** >=3.27.0
+**Version:** 0.0.1-alpha.9 · **Dart:** >=3.6.0 · **Flutter:** >=3.27.0
 
 ## Commands
 

doc/basics/profile.md

@@ -247,15 +247,15 @@ The service provider auto-registers 9 `starter.*` Gate abilities that control se
 
 | Ability | Controls |
 |---------|----------|
-| `starter.profile` | Profile information section |
-| `starter.profile.photo` | Profile photo upload/delete |
-| `starter.profile.password` | Password change section |
-| `starter.profile.email_verification` | Email verification banner |
-| `starter.profile.two_factor` | Two-factor enable/disable section |
-| `starter.profile.sessions` | Active sessions list |
-| `starter.profile.extended` | Extended profile fields |
-| `starter.profile.newsletter` | Newsletter subscription toggle |
-| `starter.profile.delete` | Account deletion section |
+| `starter.update-profile-photo` | Profile photo upload/remove section |
+| `starter.update-email` | Email field in profile information |
+| `starter.update-phone` | Phone and country code in extended profile |
+| `starter.update-password` | Password change section |
+| `starter.verify-email` | Email verification banner |
+| `starter.manage-two-factor` | Two-factor authentication section |
+| `starter.manage-newsletter` | Newsletter preferences section |
+| `starter.logout-sessions` | Logout/revoke buttons in browser sessions |
+| `starter.delete-account` | Account deletion section |
 
 Feature flags control whether the feature exists; Gate abilities control whether a specific user can access it.
 

doc/basics/views-and-layouts.md

@@ -635,3 +635,4 @@ The modal can also be used for standalone re-authentication (e.g. before a sensi
 | `MagicStarterUserProfileDropdown` | Circular avatar menu showing signed-in user info, profile links, and logout. Supports a custom `triggerBuilder`. |
 | `MagicStarterNotificationDropdown` | Bell-icon dropdown backed by a `Stream<List<DatabaseNotification>>`. Displays live unread badge, color-coded icons, and mark-as-read callbacks. |
 | `MagicStarterSocialDivider` | Horizontal "Or continue with" divider for auth forms. No parameters — pure presentation. |
+| `MagicStarterHideBottomNav` | `InheritedWidget` that signals `MagicStarterAppLayout` to hide the mobile bottom navigation bar. Wrap a route layout with this widget and check `MagicStarterHideBottomNav.of(context)` in the layout's build method. |

pubspec.yaml

@@ -1,6 +1,6 @@
 name: magic_starter
 description: Starter kit for Magic Framework. Auth, Profile, Teams, Notifications — 13 opt-in features with overridable views.
-version: 0.0.1-alpha.8
+version: 0.0.1-alpha.9
 homepage: https://magic.fluttersdk.com/starter
 documentation: https://magic.fluttersdk.com/packages/starter/getting-started/installation
 repository: https://github.com/fluttersdk/magic_starter