FlowState VESC

FlowState turns your iPhone and Apple Watch into a beautiful, real-time dashboard for your VESC-powered ride. Connect over Bluetooth to see everything your board is doing — then tune it, record it, and relive every ride.

LIVE DASHBOARD
• Big, glanceable gauges: speed, duty cycle, battery, current, and range
• Pitch, roll, and footpad sensor indicators
• Motor and controller temperatures, pack voltage, and live amps
• A smart range estimate that learns from how you ride

BATTERY & BMS
• Per-cell voltages and pack balance at a glance
• State of Health and coulomb-counted state of charge
• Smart-BMS support for accurate, sag-free battery readings

TUNE YOUR BOARD
• Read and adjust your Refloat configuration right from your phone
• Save unlimited tunes and switch between them in a tap — even from your wrist
• Import tunes from XML files

APPLE WATCH
• Live gauges on your wrist while you ride
• Switch tunes without reaching for your phone
• Ride alerts buzz your wrist
• Connect/Disconnect to board

RECORD & RELIVE
• Record your ride with the dashboard composited over your footage (picture-in-picture)
• Automatic ride history with GPS maps, distance, top speed, duty, and energy used
• Trip stats, odometer, and lifetime totals

RIDE ALERTS
• Real-time pushback, footpad, and over-duty alerts
• Persistent warnings so you never miss a critical condition
• Keeps tracking in your pocket on long rides

MAKE IT YOURS
• Multiple visual themes, including a neon Retro Arcade look
• Demo mode to explore the app without a board connected

How FlowState was built — and what it can and can't do

Openly: FlowState was made by an independent solo developer with the help of Claude, an AI coding assistant. Since a few riders have asked, here's exactly what's going on.

What actually controls your board isn't this app, and isn't AI. The VESC firmware runs the motor, and the Refloat package — open-source, human-written firmware on the board — does the real-time balancing many times a second. That's what controls your ride. FlowState runs on your phone, outside that loop: it displays the data Refloat broadcasts and, only when you choose, sets Refloat's settings within its own limits. Your board rides exactly the same whether your phone is connected, pocketed, dead, or absent — and nothing is "AI-controlled" while you ride. Claude helped write the code; it doesn't run while you ride. In short: FlowState monitors and configures; Refloat controls.

FlowState has been thoroughly tested on real hardware and stays within safe boundaries:

- It only reads and writes the Refloat package's settings — the same values you can adjust in VESC Tool, Float Control, or Floaty — always within the ranges Refloat allows, using Refloat's own format.
- It does not modify VESC firmware or your motor configuration. No firmware flashing, no motor detection, no FOC, current-limit, or hardware changes.
- It cannot push values outside Refloat's limits, and it does not bypass your board's built-in fault and safety systems.
- Battery/BMS: the only battery-management change it can make is the charge limit — locked to the specific BMS model and firmware versions it's been tested against, and disabled on anything else.

Note: FlowState doesn't double check your VESC/motor configuration like Float Control — after setting up or reconfiguring your board, double-check it in Float Control before riding.

FlowState was inspired by Float Control and Floaty and owes a lot to them — sincere thanks to their creators for paving the way for tools like this. Questions or concerns: flowstate.vesc.support@gmail.com.

FlowState is free. An optional Tip Jar and the Retro Arcade theme help cover Apple's fees and fund new features.

FlowState is an independent app for VESC-based boards running the Refloat package. It is not affiliated with, endorsed by, or sponsored by the VESC project, Benjamin Vedder, Refloat, or any board manufacturer.