Added #

• Documentation:
  • Added comprehensive flutter_riverpod integration examples in README
  • Added RiverpodInspector usage examples
  • Added InspectableProviderListener reusable widget example
  • Added complete Riverpod example with ProviderScope

Added #

• Environment Switcher:

  • Switch between dev, staging, and production environments at runtime
  • Environment model with id, name, baseUrl, socketUrl, description, and config
  • DebugEnvironmentManager for managing environments
  • EnvironmentPresets for quick setup (development, staging, production)
  • Environment change listeners for updating API clients
  • Export/import environment configurations
  • Environment persistence support
  • Quick environment type checks (isDevelopment, isStaging, isProduction)
  • Custom config values per environment (timeout, debug flags, etc.)

• State Inspector:

  • Monitor state changes from Provider, Riverpod, BLoC, and GetX
  • StateManagementType enum for different state management solutions
  • InspectedProvider for tracking provider state
  • StateChange model with before/after values and timestamps
  • DebugStateInspector for registering and tracking providers
  • State change history with configurable max size
  • Filter changes by provider or state type
  • Search functionality across state changes
  • Export state data as JSON
  • Real-time state change notifications

• New Panels:

  • Environment Panel for switching environments
  • State Panel for inspecting state changes

• Testing:

  • Comprehensive unit tests for Environment Manager (18 tests)
  • Comprehensive unit tests for State Inspector (19 tests)

• Documentation:

  • Updated README with Environment Switcher usage
  • Updated README with State Inspector usage
  • Updated feature list with new capabilities

Added #

• Debug Overlay:

  • Full-screen modal panel that appears above your app UI
  • Animated show/hide transitions`
  • Gesture triggers (long press, three-finger tap, device shake)
  • Clear all button for logs and network requests

• Logs Panel:

  • Timestamped log messages
  • Log level filtering (debug, info, warning, error)
  • Search functionality
  • Copy logs to clipboard
  • Export logs as JSON
  • Tap to view details in modal bottom sheet
  • Auto-scroll to latest logs
  • Color-coded log levels
  • Tag support for categorization

• Network Panel:

  • Dio interceptor for HTTP logging (DebugNetworkInterceptor)
  • Request URL, headers, and body display
  • Response status code, headers, and body display
  • Response time tracking
  • Filter by status (success/failed)
  • Search by URL
  • Color-coded HTTP methods (GET, POST, PUT, PATCH, DELETE)
  • Color-coded status codes
  • Formatted JSON body display
  • Copy request/response to clipboard
  • Detailed request viewer with tabs (Overview, Headers, Request, Response)

• Device Panel:

  • App information (name, version, build number, build mode)
  • Device information (model, manufacturer, OS version)
  • System information (platform, Dart version, processors)
  • Copy values to clipboard
  • Platform-specific info (Android, iOS, Web, macOS, Windows, Linux)
  • Loading state while fetching device info

• Storage Panel:

  • View all SharedPreferences keys/values
  • Type indicators (String, Int, Double, Bool, List)
  • Search functionality
  • Delete individual keys
  • Clear all storage with confirmation dialog
  • Copy values to clipboard
  • Value detail view

• Features Panel:

  • Register feature flags with name, description, and category
  • Toggle flags on/off
  • Enable/disable all flags
  • Reset to defaults
  • Grouped by category
  • Search functionality
  • Export/import flags

• Theming System:

  • Built-in color schemes (darkCyan, darkPurple, darkGreen, darkOrange, lightBlue)
  • Custom theme support via DebugPanelTheme
  • Configurable colors for all UI elements
  • Customizable border radius and padding
  • Monospace font family support

• Common Widgets:

  • DebugSearchField - Styled search input
  • DebugActionButton - Toolbar action button
  • DebugBadge - Status/type badge
  • DebugEmptyState - Empty state placeholder
  • DebugListTile - Styled list item
  • DebugInfoCard - Key-value info display
  • DebugDetailSheet - Modal detail view
  • DebugSelectableText - Selectable text with copy

• Configuration:

  • DebugPanelConfig for comprehensive configuration
  • Enable/disable individual gesture triggers
  • Customizable long press duration
  • Theme and color customization
  • resolvedTheme getter for theme resolution

• Testing:

  • Comprehensive unit tests for all core services
  • Widget tests for panels and UI components
  • Test coverage for logger, network logger, and feature flags

• Documentation:

  • Complete API reference
  • Usage examples
  • Best practices guide
  • Architecture overview

Dependencies #

• dio ^5.4.0
• device_info_plus ^9.1.0
• shared_preferences ^2.2.2
• shake ^2.2.0
• intl ^0.19.0

Dev Dependencies #

• flutter_test
• flutter_lints ^3.0.1
• mocktail ^1.0.0

• Initial project structure
• Basic debug overlay implementation