注音之塔 · Zhuyin Spire
A browser deckbuilder for first graders (ages 5–7) inspired by Slay the Spire: climb a colorful tower with 注音符號 spell cards.
Recognize or listen for the correct 注音 to cast. Wrong answer = fizzle (energy spent). HP → 0 ends the run.
Version: 0.4.12 in package.json · Stack: Vite + TypeScript (no backend)
The current GitHub Release is v0.4.12: painted Act I–III room plates, act
transitions, map tokens, corner props, and fifteen relic icons (#89), plus
the lantern alt string corrected to 點燈人的銅提燈, darker rest-room card titles,
and the version shown on the opening menu,
[0.4.12] in
CHANGELOG.md. The previous release is v0.4.11 at e92afb7
(#88), 2026-10-29 15:46 UTC.
Two characters are playable: 共鳴武者 and 數星人.
Player notes: RELEASE_NOTES_v0.4.12.md.
Previous notes: RELEASE_NOTES_v0.4.11.md.
Play online: https://yaochunghu.github.io/zhuyin-spire/
Browser reliability and verification: docs/BROWSER_SUPPORT.md.
Integration notes: docs/STABILIZATION.md.
Quick start
Use Node 22.23.1 (see .node-version) and npm 11.19.1. From this repo root:
npm install
npm start
That opens http://localhost:5173 on this computer. Best on a tablet or large window.
npm run dev is the same local server without opening a browser. The server
listens only on your machine. To try a phone on your trusted LAN, opt in with
npm run dev -- --host 0.0.0.0.
npm run build # typecheck + production bundle
npm run test:setup # once per machine: Chromium, Firefox, and WebKit
npm test # Vitest unit suite
npm run generate:save-fixtures # rewrite tests/fixtures from the live run code
npm run test:e2e # tablet and phone smoke tests
npm run test:security:e2e # production build, then security smoke tests
npm run preview # serve dist/
The published GitHub Pages build uses /zhuyin-spire/ as Vite's production
asset base; local development remains at /.
tests/fixtures/saves/ holds ten version-4 checkpoints, one map, shop, event,
reward, and act-clear save for 共鳴武者 and one for 珠算武者.
tests/fixtures/replays/ holds the seed and the choice list that produced them.
npm run generate:save-fixtures plays both characters through the real run
code and rewrites those files. npm test loads each file through the save
parser and replays the choices with a save in between. Do not hand-edit the JSON.
Privacy and security
The game has no account system, backend, ads, analytics, tracking cookies, or
microphone access. Runs, learner nicknames, and learning progress stay in this
browser's local storage. Use a short nickname only—never enter a child's real
name. GitHub Pages may process standard connection logs such as IP addresses as
part of hosting the site.
Read the full Privacy Notice, Security Policy, and
Third-Party Notices. Security problems should be
reported privately through GitHub Security Advisories, never through a public
Issue.
Copyright and project status
Copyright © 2026 yaochunghu. All rights reserved. The source is public for
inspection and learning, but no open-source license is granted. Copying,
redistributing, publishing modified versions, or using project assets requires
prior permission. See THIRD_PARTY_NOTICES.md for the
separately licensed map-generation reference.
This is an independent educational fan project inspired by Slay the Spire.
It is not affiliated with, endorsed by, or sponsored by Mega Crit.
Who plays what
| Role | What they do |
|---|
| Child | Tap big 注音, icons, pick answers. Almost no reading required. |
| Adult | Read the 家長提示 strip; say cue words; encourage. |
The test for the child is recognizing / listening for 注音 — not reading Chinese UI.
How to play (short)
- Adult opens the game; child taps ▶️ to climb, or 📚 for practice (no HP).
- Pick a character, which sets the starting deck, deck theme, and starting relic. 共鳴武者 casts 注音. 數星人 answers three big number choices.
- Map climbs upward (StS-style web): lit rooms are branches. 3 acts, each with a boss. The last boss is shown as 終焉王. ? rooms appear in every act. 🃏 shows the deck.
- In combat, play a card (tap or drag onto enemy / shield). Cast check — spell the full first syllable:
- 聲母 + 韻母 + 聲調（ˊˇˋ˙；一聲 usually unmarked）
- Example: 爸爸 →
ㄅㄚˋ (not just ㄅ)
- 🔊 再聽 for listen modes. ✋ ends the turn. Rest at campfires (40% max HP). No free heal after every fight.
- Rewards / shop / treasure use big icons; adult text stays secondary. A chest pays gold and one relic. An elite or boss still offers a card and also drops a relic. A fight or the shop can hand out a one-use bottle. The belt has 3 slots. On a phone, each shop offer keeps its card, price, and the remove-card button on screen.
The first character starts with exactly 10 cards: 5 one-energy 基礎攻擊,
4 one-energy shields, and 1 two-energy attack that applies 易傷. Act I adds a
focused nine-card reward pool. 共鳴武者 learns four linked ideas: 易傷、
基礎攻擊／練功、攻守轉拍、and fully blocking an enemy action to gain 勁.
See docs/DECK_DESIGN.md for the live 12-design Act I wave
and the score progression that expands later-act fights, shops, and treasure
from 12 to 33, 54, and finally all 75 designs.
On a fresh installation, the first Act I battle is a one-monster guided lesson:
shield → End Turn → attack → finish normally. The ⚙️ button is available on every
screen for volume, 1×/2× gameplay animation, tutorial replay, and detailed
curriculum controls. Up to four children can keep separate runs, tutorials,
badges, practice results, and casting history; switch learners from the title.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
