explaingit

ytnrvdf/wha-spell-simulator

Analysis updated 2026-05-18

415JavaScriptAudience · vibe coderComplexity · 3/5Setup · easy

TLDR

A browser app inspired by Witch Hat Atelier where you draw spell diagrams on a canvas that get parsed into structured output and animated visual effects.

Mindmap

mindmap
  root((spell simulator))
    What it does
      Draw spell diagrams
      Parse into GlyphAST
      Compile to SpellIR
      Animate effects
    Tech stack
      JavaScript
      Vite
      Node.js
    Use cases
      Fan spell drawing
      Sigil experimentation
      Diagram reference
    Audience
      Manga fans
      Hobbyist coders
      Canvas tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Draw fan-made spell diagrams and see them parsed into structured shape and behavior data.

USE CASE 2

Experiment with sigil and modifier combinations using the built-in detector and effect labs.

USE CASE 3

Reference the Dictionary panel for sample spell layouts before drawing your own.

What is it built with?

JavaScriptViteNode.js

How does it compare?

ytnrvdf/wha-spell-simulatorsecops-7/mikrodashopen-gsd/get-shit-done-redux
Stars415399398
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderateeasy
Complexity3/53/53/5
Audiencevibe coderops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Runs on Vite, recognition works best with clean, deliberate drawings on the canvas.

No license information is stated in the README.

In plain English

This is a fan-made browser application inspired by the manga Witch Hat Atelier, a series in which spell casting works through drawing geometric diagrams. The app lets a user draw a spell diagram on a canvas and then runs it through a parser to produce structured output and animated visual effects. Drawing on the canvas produces a freehand diagram. The app detects one enclosing ring and classifies the spell as either prepared or active based on its state. It recognizes a dictionary of primary sigils corresponding to five elements: fire, water, wind, earth, and light. It also recognizes modifier signs that affect direction, levitation, convergence, force, spread, focus, range, duration, and stability. Once the diagram is parsed, the app produces three kinds of output for inspection: a GlyphAST representing the recognized shapes, a SpellIR representing the compiled spell behavior, and animated canvas effects that visualize the element associated with the spell. A Dictionary panel shows sample spell layouts as drawing references. Parser diagnostics appear when a drawing has problems. The project includes a set of developer reference tools accessible from the app: a stroke template maker and viewer, a sigil and sign detector lab, and a spell effect lab for tuning visual animations. The full codebase is JavaScript, runs on Vite, and includes a Node test suite. The README is candid about limitations. The app supports one spell ring and one primary sigil at a time, and recognition works best with clean, deliberate drawings. The sigil dictionary covers a small fan-made subset rather than any canonical rule set, and the visual effects are interpretive rather than faithful reproductions of the manga's artwork. The project is not affiliated with the official creators.

Copy-paste prompts

Prompt 1
Explain how the GlyphAST and SpellIR outputs relate to each other in this spell diagram parser.
Prompt 2
Write a JavaScript function that adds a new modifier sign to the sigil dictionary used by this app.
Prompt 3
How would I add a second spell ring to support layered spells in this parser?
Prompt 4
Draft test cases for the Node test suite that check recognition of the fire and water sigils.

Frequently asked questions

What is wha-spell-simulator?

A browser app inspired by Witch Hat Atelier where you draw spell diagrams on a canvas that get parsed into structured output and animated visual effects.

What language is wha-spell-simulator written in?

Mainly JavaScript. The stack also includes JavaScript, Vite, Node.js.

What license does wha-spell-simulator use?

No license information is stated in the README.

How hard is wha-spell-simulator to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is wha-spell-simulator for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.