MicroMap

Native macOS configurator for the Work Louder Figma Creator Micro.

Documentation

• Architecture — application structure, state flow, persistence, and runtime services.
• Hardware and VIA — physical matrix, special controls, Raw HID commands, and known firmware limits.
• Product and UI decisions — keycap rules, layer indicators, assignment model, and native macOS direction.
• Development record — decisions and discoveries made while building the current prototype.
• Privacy policy — no data collected, no network connections.

Current capabilities

• Detects the Creator Micro over native IOKit HID (VID 0x574C, PID 0xE6E3).
• Reads VIA protocol metadata through the Raw HID interface.
• Includes a searchable catalog of Figma actions verified end-to-end against the live Figma app on real hardware, including keys Figma binds by physical position rather than typed character.
• Uses the original key textures, controller controls, and shortcut icons from the Work Louder x Figma Community file (CC BY 4.0).
• Maps assignable actions to 14 keys, two encoder presses, and both encoder directions across four layers.
• Reserves the Figma key for a global ⌃⌥⌘F action that launches or activates Figma without Accessibility permission.
• Keeps the Smiley key reserved for firmware layer switching and mirrors that behavior in the preview.
• Offers an explicit Launch at Login toggle in Settings.
• Observes Figma activation through NSWorkspace.didActivateApplicationNotification for bundle identifier com.figma.Desktop.
• Uses configurable active-Figma and outside-Figma perimeter presets in the main window's Lights mode (effect, brightness, speed, color) with a live hardware preview. Defaults: bright rainbow swirl in Figma, dim white breathing outside.
• Detects both controller lighting zones at runtime. The tested Figma Creator Micro firmware reports perimeter RGB Light on channel 2 and per-key RGB Matrix on channel 3; lighting writes are serialized and retried after the VIA handshake.
• Controls the key matrix independently of the perimeter and selected layer: it stays off outside Figma and uses a configurable preset while Figma is active (including Layer 0) — solid color, breathing, rainbow cycle, raindrops, press-reactive typing heatmap, or digital rain. Per-key colors would require a firmware extension; stock VIA exposes only zone-wide values.
• Persists draft mappings locally before touching the controller.
• Writes all four layers only after an explicit confirmation.
• Shows layers Layer 0–Layer 3 in the same order as VIA indexes 0–3.
• Marks multi-key macros (such as the double-tap 0% opacity) that cannot yet be written directly.

Run

Open MicroMap.xcodeproj in Xcode and run the MicroMap scheme — the app target owns Info.plist, entitlements (App Sandbox + USB), the icon, and signing, while the MicroMapKit local package carries all sources, resources, and tests (swift test works from the command line).

To sign builds, copy App/Signing.local.xcconfig.template to App/Signing.local.xcconfig (gitignored) and set your own Apple Developer Team ID.

Command line:

./script/build_and_run.sh

Optional modes:

./script/build_and_run.sh --verify
./script/build_and_run.sh --debug
./script/build_and_run.sh --logs

Safety model

Dragging or assigning an action only updates the local draft. The controller's onboard keymap changes only after pressing Apply and confirming the alert. The app does not flash or replace firmware.

Lighting compatibility

The stock VIA protocol exposes RGB Light effect, speed, HSV color, and brightness, but it does not expose the controller's current active layer, encoder turns, or per-LED frame streaming. This app therefore follows the layer selected in its controller workspace. A firmware extension that reports layer_state is required to follow layer changes made solely on the physical Smiley key. Exact dial-stepped perimeter motion likewise requires a per-LED firmware endpoint. A host-only approximation can reserve the top-left encoder for global F18/F19 hotkeys and run the stock snake in the matching direction while the dial is turning.

License, attribution, and affiliation

The source code is licensed under the MIT License. Bundled keycap and controller artwork comes from the Work Louder x Figma Figma Community file by RobertCulver (CC BY 4.0) — see NOTICE.md for full attributions, trademark notes, and protocol acknowledgements (QMK / VIA).

This is an independent, community-made configurator. It is not affiliated with, endorsed by, or sponsored by Figma, Inc. or Work Louder. Figma is a trademark of Figma, Inc. Creator Micro is a product of Work Louder.