2026-07-16

Manage Multiple Configurations, and Experience a Blazing Fast Workspace

July 16, 2026

This release introduces major updates to streamline your layout design workflow. You can now save, duplicate, search, and bulk-export multiple configurations natively from a new workspace sidebar, as well as import remote configurations and submodules directly from Gitea and Forgejo repositories (including Codeberg). The Monaco editor has been optimized for lag-free typing, and a two-step share modal lets you selectively choose which custom footprints and templates to bundle. The app can also be installed as a Progressive Web App (PWA) for complete offline usage. Finally, we modernized our build stack, shrinking the built application footprint from 22MB to 8MB while doubling the production build speed.

What changed:

• Multi-configuration management: Natively switch, search, rename, duplicate, and bulk-compile multiple keyboard configurations in a new sidebar navigation panel
• Zero-lag Monaco editor: Implemented uncontrolled editor integration and a 500ms debounce to eliminate cursor jumps and interface lag while editing
• Gitea & Forgejo integration: Added an abstract provider registry to fetch configurations, footprints, and custom templates directly from Gitea, Forgejo, or Codeberg repositories
• Full offline PWA support: Install Ergogen Web UI as a standalone app with complete offline caching, background update notifications, and offline analytics queueing
• Smart footprint & template sharing: Added a two-step Share modal with background analysis that automatically filters out unused custom footprint libraries
• Modernized Vite build stack: Migrated toolchain to Vite and pnpm, shrinking the production built size from 22MB to 8MB and doubling build speed
• End-to-End binary STL pipeline: Feeds raw ArrayBuffers directly from the background compilation worker to the 3D preview and ZIP exporter, eliminating UTF-8 conversion overhead
• Performance optimizations: Flattened offset mappings for 22% faster binary STL parsing, and implemented centralized directory caching for 37% faster ZIP exports
• Shared link version checking: Detects and alerts users with a warning modal when a shared link is opened on an incompatible GUI version or custom Ergogen fork
• Interactive Version Badges: Added clickable GUI/Ergogen version footer buttons and a superscript beaker chip indicating custom development builds
• Curly-45 layout example: Added the popular Curly-45 column-staggered configuration under the "Miscellaneous" welcome menu examples, courtesy of @peterjc

Full Changelog: v20260605...v20260616

2026-06-05

Custom Templates Support in GUI

July 05, 2026

Creating and editing custom outlines or templates previously required running the tool offline. You had no way to create, view, or manage your custom Ergogen outlines or templates inside the web interface.

Now you can manage custom templates directly from the settings panel, complete with template name editing, code editing, and conflict resolution. You can add, load from local files or folders, and fetch directly from a templates/ or outlines directory in your GitHub repositories. When exporting, your custom templates are also saved in the generated ZIP.

What changed:

• GUI for custom templates: Created a new tab in custom libraries to add, edit, and delete templates in your design
• GitHub & local ZIP template extraction: Automatically extract templates from templates/ folder when loading from GitHub or local archives
• Clean template exports: Save footprints, outlines, and templates to their respective directories when downloading the configuration ZIP
• Default boilerplate structures: Added helper boilerplates for newly created custom templates and custom outlines

Full Changelog: v20251103...v20260605

2025-11-03

Share A Link To Your Keyboard Configuration

November 3, 2025

Sharing your keyboard design with others used to be a hassle. You'd have to export your configuration file, package up all your custom footprints separately, and send multiple files or links. The recipient would then need to load everything manually, making collaboration tedious and error-prone.

Now you can share your entire keyboard configuration – including all custom footprints – with a single link. Click the share button and a dialog appears with your personalized shareable URL. The link is automatically copied to your clipboard, ready to paste anywhere. Recipients can simply click the link to load your complete configuration with all custom components intact.

What changed:

• Shareable links: Generate a single URL that contains your keyboard configuration
• Complete configuration sharing: All custom footprints and templates are included in the shared link

Full Changelog: v20251102...v20251103

2025-11-02

Load Configurations from Local Files

November 2, 2025

Working with keyboard configurations used to mean you could only start from scratch or load from GitHub. If you had a configuration file saved on your computer, you'd need to copy and paste it manually – and forget about loading custom footprints that way!

Now you can load entire keyboard configurations directly from your computer. Simply click the "Choose File" button or drag and drop any supported file onto the page. The app accepts YAML and JSON configuration files, as well as ZIP and EKB archives that include both the configuration and custom footprints.

When loading archives, the app automatically extracts custom footprints from the footprints folder, just like when loading from GitHub. If you already have footprints with the same names, you'll see the same friendly conflict resolution dialog to choose how to handle duplicates.

What changed:

• Local file loading: Load configurations directly from your computer using YAML, JSON, ZIP, or EKB files
• Drag and drop support: Drop files anywhere on the welcome page for quick loading
• Archive support: ZIP and EKB archives automatically extract configurations and footprints
• Conflict resolution: Same interactive dialog for handling duplicate footprints as GitHub loading

Full Changelog: v20251013...v20251102

2025-10-13

Load Keyboards Directly from GitHub

October 13, 2025

Ever wanted to share your keyboard design with a friend or try out someone else's layout? You can now load complete keyboard configurations directly from GitHub, including all the custom footprints!

Previously, loading a configuration from GitHub only brought in the basic layout file. You'd have to manually recreate any custom components (like special switches or connectors) that the design depended on. This was time-consuming and error-prone, often leading to confusing errors about missing parts.

Now, when you load a keyboard from GitHub, the app automatically discovers and loads all custom footprints from the repository – even those stored in separate libraries using Git submodules. If you already have a footprint with the same name, you'll get a friendly dialog asking whether to skip, overwrite, or keep both versions.

The app also got smarter about finding configurations. It can now search through entire repositories to locate the right files, and it'll warn you if you're running low on your hourly request allowance so you know to take a break before trying again.

What changed:

• Automatic footprint loading: Custom components are now loaded alongside configurations from GitHub repositories
• Smart conflict resolution: Interactive dialog lets you choose how to handle duplicate footprint names
• Git submodule support: Loads footprints from external libraries referenced in the repository
• Intelligent file discovery: Searches entire repositories to find configuration files in any location
• Usage monitoring: Proactive warnings when approaching GitHub's request limits, with clear guidance
• Better feedback: Loading progress bar now appears when fetching from GitHub