ESP32 + Flutter BLE Starter — Production-Ready Bluetooth Template
Connect a Flutter app to an ESP32 over Bluetooth Low Energy — without losing two weeks to the parts nobody warns you about.The free demos on GitHub stop at "connect and read once." This template ships the hard part solved: an explicit connection state machine, automatic reconnect with exponential backoff, permission-aware scanning, MTU negotiation, and chunked writes — on both sides, mirrored to the same UUID contract.WHAT'S INCLUDED- Framework-agnostic Dart BLE service — pure Streams, no Riverpod/Bloc/Provider lock-in. Drops into any state management.- Explicit connection state machine (idle → scanning → connecting → discovering → ready → reconnecting) you can drive UI straight from.- Automatic reconnect with exponential backoff on unexpected drops — never fights a user-initiated disconnect. Rides through power loss and app backgrounding on its own.- MTU negotiation + automatic chunking on the write path, so outgoing payloads never silently truncate.- Matching ESP32 firmware (PlatformIO + NimBLE): GATT server, advertising, re-advertise on disconnect — a WRITE command channel and a NOTIFY sensor channel already wired.- A runnable Flutter example screen: scan, connect, send commands, watch live notifications. Not a snippet — the actual app in the demo.- Android permissions and iOS Info.plist handling done, with the "empty scan" gotchas documented.WHAT IT DELIBERATELY LEAVES OUTThis is the lean, reliable core — not a kitchen sink. WiFi-provisioning over BLE, OTA firmware updates, pairing/bonding with encryption, and multi-device management are intentionally out of scope (planned for an extended build).TESTED ONDeveloped and shipped working on Android. The iOS half is included and built to Apple's requirements (Bluetooth usage strings, Core Bluetooth permission flow) but has not been verified on iOS hardware — verify on your own device before shipping to iOS.STACKFlutter · flutter_blue_plus · ESP32 · PlatformIO · NimBLE · single-developer commercial license (build unlimited personal & commercial products; no reselling the template itself).
Get it → buildwithsnail.gumroad.com