Skip to content

Building Firmware

This functionality requires you to be logged into your account.

The MoErgo Layout Editor provides a quick and simple way to build firmware. Unlike the traditional ZMK approach, there is no need to create a GitHub repository or install a compiler toolchain on your computer.

For Saved Layouts

Build button

To build firmware for a layout you are viewing, click the Build button.

For Layouts Being Edited

Save and Build button

To build firmware for a layout you are currently editing, click the Save and Build button. It is located in the multi-button on the right.

After automatically saving, the firmware will be built, and a post-build dialog will be shown. After dismissing the dialog, the Layout Editor will redirect you to the saved layout.

Firmware Version

By default, the MoErgo Layout Editor always uses the latest production firmware appropriate for the keyboard.

However, it is possible to select other available firmware versions in the Settings menu, by clicking on the Settings in the top menu bar. Please note that the firmware version is intentionally not persisted across sessions.

Firmware Filename

Generated firmware follows the following convention: 

<layout_id>_<firmware_version>_<layout_name>.uf2
For example: 4dbe5662-0442-4ba0-ae60-4f013edd3479_v25.08_Glove80 Factory Default Layout.uf2

Layout Visibility

After the build is complete, a dialog will be shown with the build result and firmware update hints.

Post-Build Dialog

Post-Build Dialog

If this is the first successful build for this layout, you will be given the option to set the layout visibility to Public or Unlisted.

  • Public: The layout will be visible to everyone and will appear in public search results. This is useful for sharing your layout with the community. The layout will be Public by default.

  • Unlisted: The layout will not appear on the Search page, but it will still be visible to anyone with the URL.

You can always change the layout visibility later on the My Layouts page.

Loading Firmware

Please see the Glove80 User Guide section "Loading new ZMK firmware onto your Glove80" for details.

Build Limits

To ensure that everyone has a fair opportunity to build firmware through the MoErgo Layout Editor, there are daily and weekly limits on the number of builds a user can perform.

It is unlikely that you will ever reach these limits. However, if you do, please wait a while before trying again.