Skip to content
Back to search

rubber-hose-ui

Eleven ordinary UI controls drawn as rubber-hose cartoon characters. One file each, no dependencies.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/finktheartist--rubber-hose-ui/badge.svg)](/listings/finktheartist--rubber-hose-ui)

HTML

<a href="/listings/finktheartist--rubber-hose-ui"><img src="/api/listings/finktheartist--rubber-hose-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines
  1. # Rubber Hose UI
  2. Ordinary UI controls as a 1930s rubber-hose cartoon, in which every control is a character. The button is a red dome who gets bopped. The slider is a trombone and his slide is the track. The toast notification is a toaster. Under each drawing is a real control, so they work with a keyboard, a screen reader and a form.
  3. Each one is a single file that defines a custom element, with its drawings inside it, so there is nothing else to fetch. No dependencies, no build step for you, MIT licensed.
  4. ![The title card: Rubber Hose UI in "Controls on Parade"](gallery/title.jpg)
  5. ## The eleven
  6. | | element | who he is |
  7. |---|---|---|
  8. | [Button](button/) | `<hose-button>` | A red dome with a grin. Press him and a gloved fist flattens him, with stars and BOP!. He springs back black-eyed and bandaged, with birds going round his head. |
  9. | [Toggle](toggle/) | `<hose-toggle>` | The knob is a lightbulb. Switch it on and he stretches across like taffy, lights up and throws his fists in the air, with CLICK!. |
  10. | [Slider](slider/) | `<hose-slider>` | A trombone. His slide is the track and his own hand on its handle is the thumb. A fast pull gets a TOOT!. |
  11. | [Checkbox](checkbox/) | `<hose-checkbox>` | A square fellow who ticks himself: his own arm swings round and slaps the check mark on, with SPLAT!. |
  12. | [Radio](radio/) | `<hose-radio>` | Round faces, one to a choice. Only the chosen one is awake; pick a sleeper and he pops awake with POP!. |
  13. | [Input](input/) | `<hose-input>` | A text field with a fountain pen standing on the caret. He hops on every letter and flicks ink. |
  14. | [Tabs](tabs/) | `<hose-tabs>` | Folder tabs on a rail. The active one stands up with his fists in the air and his legs kicking underneath. |
  15. | [Progress](progress/) | `<hose-progress>` | A thermometer on his side. The red climbs while he strains and sweats; at a hundred, PHEW!. |
  16. | [Rating](rating/) | `<hose-rating>` | Five stars in a chorus line. The ones you have given kick in time; the rest are asleep. |
  17. | [Toast](toast/) | `<hose-toast>` | A toaster. He braces, shakes, and a slice with the message written on it jumps out of his slot, with DING!. |
  18. | [Tooltip](tooltip/) | `<hose-tooltip>` | A bird pops up from behind the question mark towing the hint on a balloon, with TWEET!. |
  19. ## The look
  20. Thick brush-ink outlines of uneven weight, flat colour over watercolour washes, pie-cut eyes, white four-fingered gloves and big cream shoes. The bodies, faces, gloves, shoes and sound-effect lettering are painted layers. The arms and legs are drawn in code, because a rubber-hose limb is a thick ink line with no elbow and has to stretch as far as the control needs. Everything alive bounces to one beat.
  21. The gallery page adds the film: paper, grain, dust, a flicker and a gate that does not hold quite still. That belongs to the page, not to the controls.
  22. ## Try them
  23. Live: https://rubber-hose-ui.vercel.app
  24. Or run it yourself:
  25. ```sh
  26. python3 -m http.server 8000 # from this folder
  27. # open http://localhost:8000/
  28. ```
  29. That opens the gallery, with all eleven live.
  30. ## Use one
  31. Each is a single file that defines an element. Install it with the shadcn CLI, which puts the file in `public/rubber-hose-ui/`:
  32. ```sh
  33. npx shadcn add finktheartist/rubber-hose-ui/button
  34. npx shadcn add finktheartist/rubber-hose-ui/toggle
  35. npx shadcn add finktheartist/rubber-hose-ui/slider
  36. # ...checkbox, radio, input, tabs, progress, rating, toast, tooltip
  37. ```
  38. Or copy the file into your project by hand. Then load it with a plain script tag and use its element:
  39. ```html
  40. <script src="button.js"></script>
  41. <hose-button>Confirm</hose-button>
  42. <script src="toggle.js"></script>
  43. <hose-toggle label="Lights"></hose-toggle>
  44. <script src="progress.js"></script>
  45. <hose-progress label="Uploading"></hose-progress> <!-- then el.set(0.4) -->
  46. ```
  47. Each folder's README lists the attributes, properties and events. The value controls (toggle, slider, checkbox, radio, input, rating) work inside a `<form>` like the native ones.
  48. - **Size.** Each is a drawing 300 pixels wide with the control over it. Give the element another CSS `width` and the whole thing scales.
  49. - **The line.** Every character has something to say about what just happened ("Checked. He did it himself and he is very proud."). It is in `el.line`, and each new one fires a `hose:line` event with `{ text }`. The gallery types it under each control; you can show it or ignore it.
  50. - **How the files share.** Each file carries its own painted layers and a copy of the core (the clock, the limbs, the gloves, the shoe and the lettering face, about 80 KB). The first one loaded sets `window.RubberHose` and the others reuse it, so any mix of them on a page shares one clock. The files are between 95 and 210 KB.
  51. For agents, [llms.txt](llms.txt) lists every file and what it is. In the gallery each control has its install line and a "Copy a prompt" button; the prompt points a coding agent at the real file and tells it to wire it in, not redraw it.
  52. ## Make your own
  53. `skills/rubber-hose-ui/` is the workflow these were made by, written as a skill for a coding agent. Install it with:
  54. ```sh
  55. npx skills add finktheartist/rubber-hose-ui
  56. ```
  57. Or copy the folder into your agent's skills folder by hand (for Claude Code, `~/.claude/skills/`). It has:
  58. - `SKILL.md`, the workflow and the rules. Most of the rules are about joins: where a limb starts, which way a thumb points, how a leg goes into a shoe.
  59. - `core.js`, the core every component is built on.
  60. - `starter.html` and `art/`, the smallest whole example: a favourite button who is a star.
  61. - `look.mjs`, which stops the clock, steps a reaction to chosen moments and saves the frames side by side.
  62. An agent with the skill gets a reasonable first pass. These took many rounds of looking at close-ups and fixing joins, and yours will too.
  63. [making-of/](making-of/) is how the painted parts were made: the three concept directions, every image prompt, and how a generated sheet becomes layers with limbs attached.
  64. ## Working on this repo
  65. - `core.js` is the source of the shared core. After editing it, run `node tools/build.mjs`, which stamps it and each component's layers into every component file (between the `// >>> hose core` and `// >>> art` markers) and into the skill. `node tools/build.mjs --check` exits 1 if any file is out of date.
  66. - `art/` holds the painted layers at the size they are shipped. `tools/build.mjs` lists which component carries which. `tools/art.sh RAWDIR` rebuilds them from the full-size generated sheets, which are not in the repo.
  67. - `tools/spec.mjs` says what each component is. `node tools/docs.mjs` writes every folder's `README.md` and `index.html`, `registry.json` and `llms.txt` from it, so edit the spec and not those files.
  68. - `node tools/test.mjs http://localhost:8000/gallery/?nofilm` drives every control with real touch and key events at phone width, checks form values, scaling and sideways scroll, and exits 1 on a failure. `node tools/shot.mjs URL OUT W H SCALE` takes a full-page screenshot. Both need Chrome or Chromium (`CHROME=...` if it is somewhere unusual).
  69. ## Limits
  70. - **Checked in headless Chromium,** with real touch and key events and frame-by-frame sheets. Not yet tried in Safari or Firefox, on a real phone, or with a screen reader.
  71. - **Drawn for a light page.** The ink is dark brown; on a dark background the outlines disappear.
  72. - **The labels are not shown.** The button's and the checkbox's text is their accessible name only, because the drawing is the control. Put a visible label beside them.
  73. - **English lettering.** The sound effects and the toggle's ON and OFF are painted.
  74. - **No sound.**
  75. - **Reduced motion** goes straight to each end state and holds still.
  76. ## License
  77. MIT. See [LICENSE](LICENSE). The characters are original designs; no existing cartoon's or game's characters are used. The painted layers and the title card were generated with GPT Image (through Higgsfield) for this project. The lettering face is [Patrick Hand](https://fonts.google.com/specimen/Patrick+Hand) by Patrick Wagesreiter, under the SIL Open Font License, and is embedded in the core.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.