Skip to content

srwi/keycap_generator

Repository files navigation

Keycap Generator

Deployment CI

Open in browser

This online keycap generator creates multi-color keycap models for 3D printing from existing or custom STL keycap base models and legend definitions.

The project separates three concepts so you can reuse shapes and layout rules to produce keycaps for custom keyboard layouts easily:

  • Models: A base STL that defines the physical keycap geometry and profile. You can select from existing models or upload your own STL files.
  • Templates: A reusable placement definition that describes legend position, rotation, font, scale, and color mapping for a model.
  • Keys: A concrete instance that pairs a model with a template and specific legend text or symbol to produce an exportable mesh.

This separation makes it straightforward to assemble keyboard layouts from a small set of models and templates and export multi-color, slicer-ready 3mf-files.

Development

The project uses Bun as the runtime and package manager. To get started with development, run:

bun install
bun dev

About

Online keycap generator for multi-color 3D printing

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

Contributors