finktheartist/sakuga-vfx
Developer ToolsA set of twelve single-file web components whose buttons, toggles and inputs burst with hand-drawn anime effects on interaction.
Overview
Sakuga VFX turns ordinary form controls into small anime reaction shots. At rest, each control looks plain; when pressed, toggled or dragged, it squashes and springs back while drawn effects—smoke puffs, impact bursts, crystal chips, slashes and manga sound-effect lettering like ドン! and ズザッ—fly around it. The repo provides twelve controls: button, toggle, slider, checkbox, radio, input, tabs, progress, rating, toast and tooltip, each implemented as a single self-contained custom element.
All effects are drawn in code on one full-page canvas, and the Japanese lettering and toggle frames are baked into the component files rather than fetched at runtime. The project is meant for front-end developers and designers building playful or anime-inspired interfaces who want a drop-in component rather than a full framework.
Quick start
The quickest way to see everything is the live gallery at https://sakuga-vfx.vercel.app. To run it locally, serve the repo root over HTTP and open the gallery:
python3 -m http.server 8000
# open http://localhost:8000/
To add a control to your own page, install a single file with the shadcn CLI:
npx shadcn add finktheartist/sakuga-vfx/button
Then load the file and use the custom element:
<script src="button.js"></script>
<sakuga-button>Confirm</sakuga-button>
Value controls such as toggle, slider, checkbox, radio, input and rating participate in a <form> like native controls. Each component folder has its own README documenting its attributes, properties and events, and the llms.txt file lists every file for coding agents.
Constraints and known limits
- The project has been tested only in headless Chromium with simulated touch and key events. Safari, Firefox, real phones and screen readers have not been verified.
- Each component file carries its own copy of the ~40 KB core; the first one loaded sets
window.SakugaFXand the rest share it, so a page uses one canvas and animation loop. The toggle is around 500 KB because its 43 frames are embedded. - The effects canvas uses the highest z-index and ignores pointer events, so effects can fly over modals and sticky headers. Effects drawn behind a control are clipped by a parent with
overflow: hidden. - With reduced motion enabled, all effects are turned off while springs and state changes remain.
- Licensing is MIT. The sound-effect lettering and toggle frames were generated with GPT Image.
Customization
Control colors are CSS variables such as --sk-ink, --sk-card, --sk-pri and --sk-acc; setting a value on a page's :root overrides the defaults. The repo also ships a coding-agent skill with the core, a starter example and a frame-capture script for building your own effects.
HotRepo's take
Sakuga VFX entered HotRepo's new-project list on 2026-11-17 with 90 stars gained over the tracked window starting 2026-11-16, bringing it from around 101 to 191 stars. The design is unusual in that it packages visual polish as single, dependency-free HTML/JS files instead of a component library, and the constraints are documented honestly—headless Chromium only, effects that can layer over modals, and a large toggle payload. It suits prototypes and playful product UI more than accessibility-critical applications until broader browser and screen-reader coverage exists.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- kevintngo/looseleafA hand-drawn React component library with 123 accessible shadcn/ui-compatible parts, blocks, icons and art, distributed through a shadcn registry.
- juliangarnier/animeA small JavaScript library for animating CSS, SVG, DOM attributes and plain objects in web interfaces and browser-based visuals.
- Secretmakewomenwomen/auric-uiA React 19 component library and coding-agent skill for building AI assistant workbenches and media editors.
- emilkowalski/skillsAgent skills that give coding assistants concrete UI, animation, and interaction design guidance.
- react/reactA JavaScript UI library for building component-based web and native interfaces, used by frontend teams choosing a rendering stack.