starter_kit_flutter 1.0.0

A batteries-included foundational Flutter package for networking, connectivity, storage, theming, app updates, and core utilities.

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.

1.0.0 - 2026-09-18

Changed

• Published package name is now starter_kit_flutter (avoids clash with existing pub.dev starter_kit)
• Public import path is package:starter_kit_flutter/starter_kit_flutter.dart
• App icon CLI: dart run starter_kit_flutter:starter_kit_icons
• Compatibility export retained at package:starter_kit_flutter/starter_kit.dart

Added

Bootstrap & configuration

• One-place setup via StarterKitApp and StarterKitConfig
• Explicit module toggles with StarterKitModulesConfig (enabled / stub / disabled)
• UI behavior controls via StarterKitUiConfig
• Centralized design-system tokens via DesignSystemConfig (spacing, radius, shadows, typography)
• Manual/advanced path: StarterKit.init() + StarterKit.builder()
• Safe re-initialization support (StarterKit.init(config, true))

Core modules

• Networking: Dio-based INetworkClient with auth, logging, and retry interceptors
• Storage: SharedPreferences + FlutterSecureStorage behind IStorageService
• Theme: light/dark/system mode with persistence via ThemeManager
• Connectivity monitoring with optional offline banner overlay
• App updater with force-update and maintenance-mode screens
• Feature flags via IFeatureFlagService (StarterKit.I.featureFlags)
• Conditional UI via StarterKitSlot

Design system & utilities

• Reusable spacing widgets: VSpace, HSpace, SKSizedBox
• Context accessors: context.dsSpacing, context.dsRadius, context.dsShadow, context.dsTypography
• Crash-proof JSON helpers: SafeJsonReader and Map key-chain extensions
• Sealed Result<T, E> and sealed AppError hierarchy with pattern matching
• String / date / context extensions and form validators
• App icon CLI wrapper: dart run starter_kit_flutter:starter_kit_icons

Debug tooling

• In-app StarterKitDevPanel (debug-only / kDebugMode)
• Dev Panel tabs: Network inspector & simulator, Storage manager, Design inspector, Overlay simulator, Feature flags & key remapper
• Trigger options: floating button, triple-tap, or both (DevPanelTrigger)
• Debug Dio interceptor for request logs, artificial delay, and failure simulation

Notes

• First public release of starter_kit_flutter on pub.dev.
• Supported public surface: StarterKitApp, StarterKit.I.<service>, Result<T, AppError>.