flutter_env_switch 1.1.4

Type-safe runtime environment switcher for Flutter. Load .env files, switch configs at runtime, lock envs, and debug with a built-in panel.

1.1.4

• AppRestarter.onRestart — new optional Future<void> Function()? callback invoked before the widget tree rebuilds. Use it to re-initialise services (Sentry, Dio, etc.) that were set up in main() and need to pick up the new environment values.
• AppRestarter.builder — new WidgetBuilder? alternative to child. The builder is re-evaluated on every restart, allowing dynamic re-creation of widgets that hold references to re-created objects (e.g. GoRouter). Exactly one of child or builder must be provided.
• EnvSwitcher.enableInRelease — new bool parameter (default true). Controls whether the debug panel gesture is active in release builds. Set to false to restrict the panel to debug/profile builds only (the behaviour of prior versions).
• EnvSwitcher.enabled default changed from !kReleaseMode to true — the panel now works in release mode by default. Callers that need the old behaviour should set enableInRelease: false.

1.1.3

• Updated CHANGELOG.md to include entries for versions 1.1.2 and 1.1.3.

1.1.2

• Added CHANGELOG.md entry for version 1.1.1.
• Replaced deprecated Color.withOpacity calls with Color.withValues(alpha:) across all UI files to resolve pana static-analysis warnings.
• Corrected repository URL in pubspec.yaml to https://github.com/lazytechsavvy/flutter_env_switch.
• Bumped minimum Flutter SDK to >=3.27.0 and Dart SDK to >=3.3.0 to ensure Color.withValues is available in the target environment.

1.1.1

• Fixed deprecated Color.withOpacity calls — replaced with Color.withValues(alpha:) throughout the UI layer to eliminate pana static-analysis warnings.
• Bumped minimum Flutter SDK to >=3.27.0 and Dart SDK to >=3.3.0 to align with the Color.withValues API availability.
• Updated repository URL to the correct GitHub handle.

1.1.0

• Tap-count trigger — EnvSwitcher gains triggerMode (EnvTriggerMode.longPress | EnvTriggerMode.tapCount), tapCount (default 5), and tapWindowMs (default 3000) for the industry-standard hidden-panel gesture.
• onSwitched callback — EnvSwitcher and showEnvDebugPanel now accept an optional VoidCallback? onSwitched fired after each successful environment switch.
• In-panel key browser — the debug panel includes a collapsible "View loaded keys" section that enumerates all key/value pairs for the active environment. Sensitive keys (containing KEY, SECRET, TOKEN, etc.) are masked by default with an eye-toggle. All values can be copied to clipboard.
• EnvBadge<E> — new overlay widget that renders a persistent environment indicator badge in a corner of its child, reacting automatically to runtime switches.
• Env.currentEnvData — new static getter exposing all key/value pairs for the current environment as an unmodifiable Map<String, String>.
• EnvManager.currentEnvData — same, on the typed singleton.

1.0.0

• Locked environments — new lockedEnvironments parameter on Env.init prevents switching away from sensitive environments (e.g. production) at runtime.
• Env.isLocked static getter and EnvManager.isCurrentLocked for programmatic checks.
• EnvSwitchLockedException typed exception thrown when a locked-env switch is attempted.
• Debug panel renders a LOCKED badge and disables all environment tiles when locked.
• Restart-after-switch toggle is hidden in the panel when the environment is locked.

0.1.0

• Initial release.
• Multi-.env file loading from Flutter asset bundle.
• Enum-driven, type-safe environment switching.
• Runtime switching with SharedPreferences persistence.
• Gesture-triggered debug panel (long-press bottom sheet).
• AppRestarter for soft app restart via UniqueKey.
• EnvSwitcher widget wrapper — automatically disabled in release mode.
• Optional EnvDioInterceptor for Dio base URL injection.
• ValueNotifier-based reactive current-environment broadcasting.
• Full unit and widget test suite.