RSS
Built with Claude

A dragon that turns brush ink into watercolour

Huolong is a one-file browser piece by Sourasith, made with Claude Code: a 3D fire dragon walks over a Chinese poem in black ink, the ink blooms into watercolour under its feet, and its breath burns holes in the paper. Here is how it works and how to play with it.

a group of paint brushes sitting next to each other
Photo by Debby Hudson on Unsplash

Updated November 20, 2026: Expanded with the controls, how the page is built and what the repository does and doesn't allow.

Huolong, subtitled Ink and Colour, is a small interactive artwork that runs in the browser. A Chinese fire dragon walks across a sheet of cold-press watercolour paper. Under it sits a poem written in black brush calligraphy. Wherever the dragon steps, the ink turns into colour, and when it breathes fire the flame burns ragged holes through the sheet. Sourasith made it with Claude Code and put the whole thing on GitHub, so you can play with it and then read the commented code behind it.

What is on the page

The poem is called 火龙吟, which the page translates as Song of the Fire Dragon. It is eight lines of seven characters, set in Ma Shan Zheng, an openly licensed brush font that the page subsets and embeds. An English translation follows the poem, and the page's code reflows text around the dragon's painted silhouette as it moves. The poem tells the story you are watching: the dragon wakes in a sea of cloud, where it walks the ink turns to colour, and one long breath of flame burns the scroll until the ash drifts away on the wind.

How to play

Open the live page on GitHub Pages; there is no account, install or build step, though the single 2.8 MB file has to download first. Move your pointer and the dragon follows it. The controls are written into the page's code:

  • Move the mouse, or use the arrow keys, to steer the dragon across the poem.
  • Hold the mouse button down, or hold Space, to breathe fire and burn the paper.
  • Press R to mend the paper at once. Left alone for 15 seconds without fire, it also mends itself over about four seconds.
  • Press D to switch between the light paper the page opens on and a dark sheet.
  • The page listens for pointer events rather than mouse events only, so touch should steer and breathe fire on a phone or tablet too (we have not tested that). R and D have no touch equivalent.

If you would rather run it offline, clone the repository and open index.html in a browser. There is nothing to install or build. The per-OS open commands below are a general tip, not a step from the repository.

git clone https://github.com/madebysourasith-sudo/huolong-dragon
open huolong-dragon/index.html    # macOS; on Linux use xdg-open, on Windows start

How it is built

The repository holds two files: a short README and index.html. That HTML file is about 2.8 MB because everything is packed inside it. three.js r170 (marked MIT in the file), its glTF loader and BufferGeometryUtils are embedded as base64 data URLs, which a comment says is so the page works offline. The dragon was modelled and rigged in Blender and is stored in the page as a gzipped GLB model. According to the source comments, it was rigged over a top-down painting, and that painting, with the flame removed and the throat left open, is projected onto the model as its texture, so seen from the front it looks like the original artwork.

The paper, the black ink, the watercolour bloom and the burn are all one WebGL fragment shader. It mixes a paper texture, a baked ink layer and a burn map that a 340 by 192 simulation grid updates as the flame touches the paper. From that map the shader draws a scorched amber rim, a band of char and a glowing ember edge, and finally opens a hole. Mending is set by two values in the config, mendAfter: 15 and mendTime: 4.0, which match the 15-second wait and four-second repair. If the browser cannot create a WebGL context, the page falls back to a plain 2D canvas renderer for the burn; the 3D dragon itself still relies on three.js.

The repository has a single commit, dated November 5, 2026, and it carries a Co-Authored-By line for Claude Opus 5.5. The history doesn't show how the piece was developed before that commit, so if you want to learn how it was put together, you have to read the code, which is commented throughout.

What you can and can't do with the code

The repository has no licence file. The README only gives the font's licence, the SIL Open Font License for Ma Shan Zheng, and the embedded three.js is marked MIT. By default, code published without a licence is not licensed for reuse, so you can read it and learn from it, but you should ask the author before copying the page's own code, model or artwork into a project. The page also loads EB Garamond and JetBrains Mono from Google Fonts, so only the embedded calligraphy font is guaranteed offline; the browser substitutes fallback fonts for the English text.

Who it is for

This is a good file to study if you are learning creative coding with an AI assistant. One commented file shows a rigged 3D model, a custom shader, a burn simulation grid and text layout working together, although the libraries, model and fonts inside it are base64 blobs rather than readable source. In our view it shows the same tools that build dashboards making something closer to an illustrated book.

Our take

What makes Huolong work is restraint. It does one idea, ink turning into colour, and adds just enough interaction to make you want to keep burning the scroll. The engineering is serious: a model rigged in Blender, a shader with layered burn effects, text that flows around the dragon. Yet it still ships as a single file you can double-click. For artists who want to try agentic coding, our suggestion is to bring the idea and the painting, and let the assistant help with the shader maths. We would like to see it get a licence so others can learn from it openly.

Built by Sourasith

Source: Huolong — Ink and Colour (live demo), madebysourasith-sudo/huolong-dragon (GitHub), huolong-dragon index.html source (GitHub)

This story first appeared in the claudefox daily briefing for November 6, 2026.