diff --git a/CHANGELOG.md b/CHANGELOG.md index f95ed71..85ef3ec 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/CLAUDE.md b/CLAUDE.md index d1fdb93..39f81b5 100644 --- a/CLAUDE.md +++ b/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 diff --git a/doc/basics/profile.md b/doc/basics/profile.md index 4fd81a5..f285a11 100644 --- a/doc/basics/profile.md +++ b/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. diff --git a/doc/basics/views-and-layouts.md b/doc/basics/views-and-layouts.md index 7a7c429..8acf581 100644 --- a/doc/basics/views-and-layouts.md +++ b/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>`. 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. | diff --git a/pubspec.yaml b/pubspec.yaml index 6351c73..112a7f0 100644 --- a/pubspec.yaml +++ b/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