envified 2.0.0

Runtime environment switching for Flutter. Load .env files, switch dev/staging/prod/custom at runtime, override base URLs, and lock production config — no rebuild required.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.0.0 - 2026-05-07

Major Release 🚀 — Eight Improvements

1. Tamper Detection (verifyIntegrity)

• EnvFileParser.verifyIntegrity() computes a SHA-256 hash of each .env* file on first load and stores it in flutter_secure_storage.
• Subsequent loads recompute and compare — a hash mismatch throws the new EnvifiedTamperException.
• Opt-in via EnvConfigService.init(verifyIntegrity: true).

2. Access Token Gate (EnvGate)

• New EnvGate class exported from the public API.
• Supports PIN-only, biometric-only, or either-method authentication.
• Pass gate: EnvGate(pin: '1234') to EnvifiedOverlay to require auth before revealing the debug panel.
• PIN dialog implemented inline (no third-party packages) with 4 obscured digit fields.
• Auto-clears authentication state when the app is backgrounded.

3. Typed Get Helpers

• getBool(key) — accepts 'true', '1', 'yes' (case-insensitive).
• getInt(key) — wraps int.tryParse.
• getDouble(key) — wraps double.tryParse.
• getUri(key) — wraps Uri.tryParse, returns null on failure.
• getList(key, {separator}) — splits and trims CSV values.

4. Lifecycle Hooks

• onBeforeSwitch: Future<void> Function(Env from, Env to)? — awaited before switchTo() changes the active env.
• onAfterSwitch: void Function(EnvConfig config)? — called after switchTo() and setBaseUrl().
• Both hooks are supplied to EnvConfigService.init().
• New EnvName extension on Env with longLabel (e.g. "Development", "Production").

5. URL History Picker

• EnvStorage.saveUrlToHistory() / loadUrlHistory() — persists up to 5 recent URLs (deduped, newest-first) in secure storage.
• EnvConfigService.urlHistory exposes the list.
• EnvDebugPanel shows a "Recent" row of tappable ActionChip widgets below the URL override field.
• Tapping a chip applies the URL and updates the text field.

6. Env Status Badge (EnvStatusBadge)

• New standalone EnvStatusBadge widget.
• Colour-coded per environment (blue / orange / red / purple).
• Pulsing opacity animation (1.0 ↔ 0.7, 1.5 s) when isBaseUrlOverridden is true.
• Respects MediaQuery.disableAnimations (system reduced-motion preference).
• Configurable alignment and margin.

7. Gesture Trigger Config (EnvTrigger)

• New sealed class EnvTrigger replacing the hard-coded FAB tap.
• EnvTrigger.tap(count: 7) — N rapid taps within 800 ms (default).
• EnvTrigger.shake(threshold: 15.0) — accelerometer shake via sensors_plus, 2 s debounce.
• EnvTrigger.edgeSwipe(edgeWidth: 20) — right-edge inward swipe via Listener.
• Pass trigger: to EnvifiedOverlay.
• Added showFab: false option to EnvifiedOverlay to enable a true "stealth mode" where the floating 🌿 button is hidden and the trigger is the exclusive way to access the panel.
• Fixed a bug where taps on the panel or FAB incorrectly advanced the hidden tap count, ensuring triggers accurately reflect gesture counts.

8. Audit Log

• AuditEntry model (exported) with timestamp, action, fromEnv, toEnv, url.
• Every mutation (switchTo, setBaseUrl, clearBaseUrlOverride, reset) appends an entry to flutter_secure_storage.
• Log is capped at 50 entries; oldest are dropped.
• EnvConfigService.auditLog returns the full list.
• EnvDebugPanel shows an expandable "Activity log (N entries)" tile with the last 10 entries.

Auto-lock on Background

• EnvifiedOverlay registers an AppLifecycleListener on onHide / onPause.
• The panel closes and authentication is cleared whenever the app moves to background.

New Dependencies

• local_auth: ^2.2.0
• sensors_plus: ^5.0.0
• crypto: ^3.0.0

Breaking Changes

• Env.label now returns short form ('Dev', 'Staging', 'Prod', 'Custom'). Use the new Env.longLabel (via EnvName extension) for full names.
• EnvStorage.clear() now also deletes URL history and audit log keys.

Migration Guide from 1.0.0

// Before
await EnvConfigService.instance.init(defaultEnv: Env.dev);

// After (all new params are optional with safe defaults)
await EnvConfigService.instance.init(
  defaultEnv: Env.dev,
  verifyIntegrity: false, // opt-in
  onBeforeSwitch: null,   // optional
  onAfterSwitch: null,    // optional
  allowedUrls: null,      // optional
);

// EnvifiedOverlay — new optional params
EnvifiedOverlay(
  service: EnvConfigService.instance,
  enabled: kDebugMode,
  gate: null,                              // optional
  trigger: const EnvTrigger.tap(count: 7), // default unchanged
  showFab: true,                           // optional (set to false for stealth mode)
  child: child!,
)

---

1.0.0 - 2026-05-06

Initial Stable Release 🚀

• Runtime Environment Switching — Seamlessly swap between dev, staging, prod, and custom without rebuilding your app.
• Enterprise-Grade Security — Fully encrypted persistence layer using flutter_secure_storage. Choices and overrides are stored in Keychain/Keystore.
• Production Lock — Prevent accidental environment switches or URL overrides in production builds.
• API URL Overrides — Dynamically point your app to any backend URL at runtime (perfect for local testing or PR reviews).
• Premium Debug UI — Built-in, horizontally scrollable action chip panel and floating action button that only appears in debug mode.
• Zero-Overhead — Debug components are completely optimized out in release builds.
• Bulletproof Reliability — Comprehensive unit test suite covering parsing, models, storage, and service logic.

0.1.2 - 2026-05-06

• Security upgrade to encrypted storage.
• Storage injection for unit testing.

0.1.0 - 2026-05-06

• Initial beta release.