Skip to content

moosylog/flows4json

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,135 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 Generated by the machines!

🌊 Flows4JSON: The App Store for Keyboard Layouts

Welcome to Flows4JSON! Customizing advanced mechanical keyboards (like the Glove80 or Go60) is amazing, but adding complex features usually means staring at confusing code, copying and pasting huge blocks of text, and praying you didn't break a comma somewhere.

Flows4JSON changes all of that. We built an interactive, point-and-click "App Store" for your keyboard layout.

You simply upload your layout file, browse for the features you want, and click "Apply." The app does all the heavy lifting and gives you a perfectly updated file ready to flash to your keyboard. Zero coding required.

Launch Flows4JSON

🤔 What does this app actually do?

Usually, if you want to add cool community features (like "AutoShift" or "Home-Row Mods"), you have to suffer through dozens of manual steps and endless clicking in the Layout Editor.

There is a better way. When you build a layout in the MoErgo Layout Editor, you can save it as a .json file. Flows4JSON acts as a smart robotic assistant that reads this file. It figures out exactly where your keys are and perfectly injects these complex new features—all without breaking a single one of your existing personalizations.


📦 What is a "Flow" package?

Think of a Flow as a mini-app or a "smart plugin" for your keyboard.

Instead of reading a 20-minute tutorial on how to program a new feature, community developers can package that feature into a single "Flow." When you select a Flow in the store, it asks you a few simple preference questions (like a setup wizard) and then automatically applies it to your layout.

Examples of what Flows can do:

  • 🎨 Home-Row Mods: Automatically turns your home row (A, S, D, F, etc.) into modifier keys (Shift, Ctrl, Alt, Gui) when you hold them down, but keeps them as normal letters when you tap them.
  • AutoShift: Automatically types a capital letter if you hold a key down slightly longer than usual, meaning you never have to reach for the Shift key again.
  • 🔢 Programmer's Number Row: Swaps out your standard number row for a custom layout (like ThePrimeagen's setup) where holding a number gives you a specific coding symbol.
  • 🛠️ And much more: The community can build Flows for custom gaming layers, special macros, and complex dual-function keys.

🚀 How to use Flows4JSON

Using the app takes less than a minute. Here is the step-by-step workflow:

  1. Export your Layout: Go to your standard keyboard layout editor (like the MoErgo web tool) and download your current layout as a .json file.
  2. Open Flows4JSON: Go to the web app and click Upload Layout. Select the file you just downloaded.
  3. Go Shopping: Browse the App Store for features you want. When you find one, adjust the simple settings (like picking a "Flavor" or a "Style") and click Add to List.
  4. Apply Changes: Open your Custom List (the bottom drawer) and click Apply All to Layout.
  5. Download & Flash: Click the green Download button. You will get a brand new .json file. Just load this file back into your keyboard's editor and flash your keyboard!

⌨️ Supported Hardware

Flows4JSON is built to be smart. When you upload your layout, it automatically detects what keyboard you are using. Currently, the store supports:

  • MoErgo Glove80
  • Go60

(If a specific Flow package is not compatible with your hardware, the app will safely disable the "Apply" button so you can't accidentally break your layout!)


🤝 For Developers (Building Flows)

Are you a ZMK wizard or a jq expert? You can write your own .flows packages and share them with the community! Flows4JSON uses a powerful, isolated WebAssembly compiler to safely run layout mutations entirely in the user's browser.

Click the Toggle Developer Console button inside any app card to see exactly how the transformations work under the hood.

About

An easy-to-use app store where you can point, click, and automatically inject advanced features directly into your MoErgo JSON layout.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages