yang/via
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
365 commits 1 branch 0 tags 26 MiB
Find a file
Exact
Silent YANG e69d614020
Some checks failed
Trigger Deployment / Trigger deploy hook (push) Has been cancelled
Details
update
2025-09-15 23:22:24 +08:00
.github/workflows Fix name for workflow 2025-03-06 22:00:31 -05:00
.vscode Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
public update 2025-09-15 23:22:24 +08:00
scripts Cleanup components and refactor (#276) 2024-10-25 20:17:41 -04:00
src update 2025-09-15 23:17:52 +08:00
types Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
.gitignore update 2025-09-15 23:22:24 +08:00
.prettierrc Update prettier and reapply formatting 2021-07-23 20:57:10 -04:00
bun.lockb Update dependency 2024-10-25 20:28:31 -04:00
index.html Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
LICENSE Create LICENSE 2022-07-11 19:51:05 -04:00
package.json update 2025-09-15 23:17:52 +08:00
README.md Update README.md 2025-02-02 18:38:03 +01:00
staticwebapp.config.json Update staticwebapp.config.json 2023-07-11 23:23:58 -04:00
tsconfig.json Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
tsconfig.node.json Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
vite.config.ts Fiber 🚧🚧🚧🚧🚧 (#71) 2023-03-02 21:12:34 -05:00
yarn.lock update 2025-09-15 23:17:52 +08:00

README.md

VIA Web Application - Your keyboards best friend

android-chrome-192x192

Azure Static Web Apps CI/CD

VIA is a powerful, open-source web-based interface for configuring your QMK-powered mechanical keyboard. It allows you to customize your keymaps, create macros, and adjust RGB settings (if it has RGB) on the fly, without needing to recompile your keyboard's firmware. This makes keyboard customization easier and more accessible for everyone.

Getting VIA to support your keyboard

Are you a keyboard maker or a developer interested in adding support for your keyboard? We welcome contributions to the VIA project!

  1. The source code of the keyboard has to be merged in QMK Firmware Repositories Master branch.
  2. Your keymaps/via keymap has to be merged in VIA's QMK Userspace Repository Main branch.
  3. Create a definition in JSON format for your keyboard and submit it as a pull request to VIA's Keyboards Repository Master branch.

Please follow our Specification documentation carefully to ensure your pull request is smoothly reviewed and merged.

Local development setup

Useful commands

npm run start

Runs the app in the development mode. Open http://localhost:8080 to view it in the browser.

The page will reload if you make edits. You will also see any lint errors in the console.

npm run build

Builds a static copy of your site to the build/ folder. Your app is ready to be deployed!

npm run test

Launches the application test runner. Run with the --watch flag (npm test -- --watch) to run in interactive watch mode.

This project is tested with BrowserStack.

Looking for an offline app?

@cebby2420 has kindly made a desktop app that does so.

You can find it at https://github.com/cebby2420/via-desktop.

NOTE: This project has no official affiliation with VIA, and we cannot provide support for it.

Facing Issues?

If you encounter any issues or bugs while using the VIA web application, please report them by opening an issue in the Issues section. This will help us to track down and resolve problems, and improve the VIA experience for everyone.

Before reporting, please make sure to check if an issue has already been reported. Thank you!