Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

finktheartist/sakuga-vfx

Developer Tools

A set of twelve single-file web components whose buttons, toggles and inputs burst with hand-drawn anime effects on interaction.

331
33
HTML
MIT
2 days old

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.SakugaFX and 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

  1. kevintngo/looseleafA hand-drawn React component library with 123 accessible shadcn/ui-compatible parts, blocks, icons and art, distributed through a shadcn registry.TypeScript107
  2. juliangarnier/animeA small JavaScript library for animating CSS, SVG, DOM attributes and plain objects in web interfaces and browser-based visuals.JavaScript73,924
  3. Secretmakewomenwomen/auric-uiA React 19 component library and coding-agent skill for building AI assistant workbenches and media editors.TypeScript100
  4. emilkowalski/skillsAgent skills that give coding assistants concrete UI, animation, and interaction design guidance.Markdown54,032
  5. react/reactA JavaScript UI library for building component-based web and native interfaces, used by frontend teams choosing a rendering stack.JavaScript251,745