Web Control Guide

Getting Started

Browser Requirements

The web controller uses Web Bluetooth, which is only available in specific browsers:

Browser	Platform	Supported
Chrome	Android, Windows, macOS, Linux	✓ Supported
Edge	Android, Windows, macOS	✓ Supported
Safari	iPhone, iPad, macOS	✗ Not supported
Firefox	All	✗ Not supported
Chrome on iOS	iPhone, iPad	✗ Not supported

Connecting to Your Lights

1. Open control.html in Chrome or Edge
2. Make sure Bluetooth is enabled on your computer or Android device
3. Power on a node — its LEDs should show a pattern
4. Click the Connect button in the top-right corner of the page
5. Your browser will show a device picker — select your Mission Bike Light from the list and click Pair
6. The button turns red ("Disconnect") and the status dot turns green when connected

Connection Status

• Green dot + "Disconnect": Connected and ready
• Amber pulsing + "Connecting": Pairing in progress
• Red dot + "Connect": Not connected

Programs Programs Tab

The Programs tab is your main control center for selecting lighting patterns and adjusting brightness.

Now Playing

The banner at the top of the Programs tab shows the currently active program name. While a new program is loading, it briefly shows "Selecting…" in amber before confirming.

Mesh Brightness

The brightness slider in the Now Playing banner controls all nodes in the mesh simultaneously (0–100%). Changes apply immediately.

Auto-Switch

• Auto toggle: Enable automatic rotation through your checked programs
• Interval: Set how many seconds each program plays (5–300). The interval field appears when Auto is enabled.
• Only programs with their checkbox checked are included in the rotation

Program List

Programs are organized into collapsible categories (Fun, Flashy, Aggressive, Holidays, etc.). Tap a category header to collapse or expand it.

• Search: Type in the search bar to filter programs by name across all categories
• Check/Uncheck: The checkbox on each program controls whether it appears in Auto-Switch rotation
• Toggle All: Each category has a button to enable or disable all programs in that category at once
• Select: Tap a program's name or row to play it immediately

Nodes Nodes Tab

View and configure all nodes in your mesh. Tap any node to open its settings.

Node List

• Leader badge: The node coordinating the mesh
• Connected badge: The node you're currently connected to via Bluetooth
• Flash button: Tap to flash a node yellow for physical identification
• Refresh: Use the Refresh button at the top of the tab to reload node status

Each node card shows its name, firmware version, LED count, and current brightness.

Node Settings

Tap any node to open a settings panel from the bottom of the screen.

Basic Settings

Setting	Description
Node Name	Friendly name for this node (up to 16 characters)
Brightness	Individual brightness for this node (0–100%)

LED Settings

Setting	Description
Reverse LED Order	Flip the direction the pattern travels along the strip
Mirror Mode	Mirror the pattern — useful for symmetrical installations
LED Rotation	Rotate the pattern start point: 0°, 90°, 180°, or 270°

Motion Detection

Appears only on nodes with an accelerometer. Controls power-saving behavior when the bike is stationary.

Setting	Description
Accelerometer Sensitivity	0% disables sensing. 100% is default. Higher values detect smaller movements.
Dim Timeout	Minutes of stillness before dimming (0 = disabled)
Sleep Timeout	Minutes before entering reduced activity mode
Deep Sleep Timeout	Minutes before entering deep sleep to conserve battery

Click Apply Motion Settings to save motion detection changes.

Brake Light

Appears on nodes with accelerometer support. Automatically flashes the lights red when the bike decelerates.

Setting	Description
Enable Brake Light	Toggle the brake light feature on or off
Brake Sensitivity	Lower = triggers on gentle braking. Higher = only triggers on hard braking.
Response Speed	Lower = smoother (ignores bumps). Higher = more reactive.
Trigger Duration	How long braking must persist (in ms) before activating the light

Advanced Settings (expandable): Orientation Tracking controls how quickly the node adapts to bike tilt. Most users won't need to adjust this.

Click Apply Brake Settings to save.

Network

Captive Portal: When enabled, connecting to this node's WiFi hotspot automatically opens a browser popup. Disable it if you only use the app or web controller.

LED Hardware Settings

These settings require a node restart to take effect. Click Save & Restart Node when done.

Setting	Description
LED Count	Number of LEDs connected to this node (1–500)
Color Order	LED chip color channel order (RGB, GRB, etc.) — change if colors look wrong
Max Current	Power limit in amps to protect your battery (0.5–10 A)

Per-Node Firmware Updates

Each node can have its firmware update settings configured individually:

• Auto-Update Enabled: Whether this node checks for updates at boot
• Release Channel: Release (stable) or Pre-Release (beta)
• Check for Update: Manually trigger an update check for this node. The node will briefly disconnect from Bluetooth while it connects to WiFi to check.

Node Actions

• Flash Green: Identify this node with a green flash
• Flash Red: Identify this node with a red flash
• Restart: Reboot the node
• Factory Reset: Reset all settings to defaults. Use with caution — this cannot be undone.

Settings Settings Tab

Configure WiFi for automatic firmware updates, distribute firmware across the mesh, and view connection details.

WiFi & Updates

Connect your nodes to a WiFi network so they can check for firmware updates automatically at boot.

• Enable Internet Updates: Master toggle for automatic update checks
• Release Channel: Release (stable) or Pre-Release (beta)
• Primary WiFi: Your main network SSID and password
• Backup WiFi: Optional fallback network
• Test WiFi: Verify credentials are correct before saving
• Check for Updates: Manually trigger an update check

Firmware Distribution

Push the currently connected node's firmware to other nodes in the mesh over Bluetooth — no WiFi required.

1. Connect to the node with the firmware version you want to distribute
2. Open the Settings tab — the Distribute Firmware card shows the source node and version
3. Optionally filter target nodes by hardware type using the dropdown
4. Select the nodes to update (use Select All / Select None for convenience)
5. Click Push Firmware and monitor the progress bar

Usage Data

Share Anonymous Usage Data: Opt-in to share anonymous statistics (run time, program preferences) to help improve the project.

About

Shows the current connection status, connected device name, firmware version, and Node ID. Also includes a Light Mode toggle to switch the web controller between dark and light themes.

Troubleshooting

Connect Button Does Nothing / No Device Picker Appears

• Confirm you're using Chrome or Edge — Safari and Firefox do not support Web Bluetooth
• Chrome on iPhone/iPad also does not support Web Bluetooth — use the iOS app instead
• Make sure Bluetooth is enabled on your device
• Make sure your node is powered on and within Bluetooth range

Device Picker Appears but Node Not Listed

• Confirm the node is powered on (LEDs should be showing a pattern)
• Move closer — Bluetooth range is typically 10–30 meters in open air
• Try power cycling the node
• On some systems, toggling your device's Bluetooth off and back on clears stale scan results

Browser Blocked Bluetooth Permission

• Click the lock/info icon in the browser address bar
• Find "Bluetooth" in the permissions list and set it to Allow
• Reload the page and try connecting again

Disconnects Frequently

• Keep the browser tab in the foreground — some browsers throttle Bluetooth when a tab is backgrounded
• Stay within Bluetooth range of the connected node
• Avoid connecting to the node's WiFi hotspot at the same time; switching networks can drop Bluetooth on some devices

Colors Look Wrong

• Open the node's settings (tap its card in the Nodes tab)
• Scroll to LED Hardware Settings and change the Color Order
• Most LED strips use GRB — try that first if colors appear swapped
• Click Save & Restart Node for the change to take effect

Node Not Appearing in Node List

• Tap the Refresh button at the top of the Nodes tab
• Power cycle the missing node and refresh again
• Make sure the node is within mesh range of the connected node

Firmware Distribution Fails

• Keep the browser tab active during distribution — don't switch tabs or let the screen sleep
• Stay close to the connected node throughout the transfer
• If a node fails, try distributing to it individually rather than in a batch