← Back to list

I built the English Zi Wei Dou Shu site I couldn’t find

A live chart calculator, a thirty-two-entry English glossary, and a bridge table to Western astrology and the four-letter test — at…

charlie.chien · 2026-05-25 15:34 · 0 claps · 9.7 min read
#zi-wei-dou-shu #chinese-astrology #mysticism #紫微斗數 #命理
Open on Medium ↗
Wiki topics: 🧘 · Spirituality 🔮 · Astrology & Mysticism

I built the English Zi Wei Dou Shu site I couldn’t find

A live chart calculator, a thirty-two-entry English glossary, and a bridge table to Western astrology and the four-letter test — at 12rooms.app

§0 Opening

I built the English Zi Wei Dou Shu site I couldn’t find.

You can open it right now at 12rooms.app, type in a birth date, and walk through twelve labelled rooms — each with an English page explaining what it means. The site is called 12 Rooms, for the twelve palaces a Zi Wei chart sorts a life into, and it went live this week.

This is a 1.0. It is not a final thing. What it does have today is a chart calculator that runs in your browser, a thirty-two-entry glossary written from scratch in English, and a bridge table that lays Zi Wei vocabulary alongside Western astrology and the four-letter personality test most people have already taken. It does not predict the future. It does not call itself ancient wisdom. It doesn’t promise to be more accurate than anything you’ve already tried.

What it does is fill a gap I couldn’t find filled the way I wanted to read it. The rest of this piece is about what was in that gap and how to walk through it.

§1 Why this site didn’t exist before

If you’ve Googled Zi Wei Dou Shu in English, you’ve probably had the same experience I did. The Wikipedia page is solid. A handful of blogs run by individual practitioners are charming but unindexed. A few open-source chart calculators exist; the best of them is iztro on GitHub — MIT-licensed, well-maintained, nearly four thousand stars, with output in six languages. Its English translations, in the maintainer’s own words, are interpretive rather than canonical. When I installed iztro to power the chart calculator on 12rooms.app, I had to write a hundred-line naming layer just to keep it from labelling 命宮 as “soul” (it’s the structural anchor of the chart, not a spiritual concept) and 天府 as “empress” (it isn’t an empress; it’s a stewarding archetype).

That naming layer became the seed of the glossary on the site.

The wider picture is stranger. The English mass market for personality systems is saturated. Sanctuary, a leading Western astrology platform, has a multi-million reader base — and no Zi Wei coverage I could find. Co-Star, the iconic Western astrology app, has a userbase in the tens of millions. 16personalities, the four-letter test most people have taken at least once, gets well over ten million monthly visits. Most adjacent personality or divination layers have English-canonical writing settled — but Zi Wei Dou Shu sits in the gap.

The closest English Substack in the neighbourhood is Gwen Yi’s *The Asian Astrologer* — a thousand-plus readers, paid plan, doing genuinely good work across Asian astrology adjacent to but not specifically Zi Wei. I couldn’t find a canonical English Zi Wei vocabulary that other people could quote, argue with, or build on.

So in the English layer there’s no canonical naming, no widely-shipped chart calculator with English-canonical labels, and no bridge table between Zi Wei and the systems Western readers already know. The tens of millions of Co-Star users, the millions of sixteen-type readers — if any of them ever wondered whether there’s a different framework for thinking about the shape of a life, the answer in English has been: yes, but you’ll have to learn enough Chinese to start.

That’s the gap. The site is what I built to fill it.

§2 What’s live today — three things you can do right now

Here’s what 1.0 actually contains, and the way I’d suggest walking through it.

Try the chart

Open 12rooms.app/chart. Type a birth date — year, month, day — and an hour (zero through twenty-three; the calculator handles the early-late zi-hour distinction internally). Pick a gender; this is binary in the underlying system, which is a friction worth flagging, and the page does flag it.

What you get is a twelve-cell grid arranged the way Zi Wei traditionally arranges it — a four-by-four ring with the four centre cells holding the chart metadata. Each outer cell is a palace, labelled in English: Life, Spouse, Career, Wealth, and nine more. Inside each cell are the main stars that landed there for your chart. Two coloured rings show where your Life Palace and Body Palace sit. Every name in the chart is a link back to the glossary — click “Slayer Star” and you land on a seven-hundred-word page that explains what the lone-fighter archetype means, what it doesn’t, and where Western astrology has the closest reference.

The engine — iztro again, with the canonical-naming layer applied — runs entirely in your browser. The calculation happens client-side; no account or backend processing is needed. The chart URL encodes your inputs (?d=YYYY-M-D&h=H&g=m), so you can bookmark or share a chart — but treat the link as containing the birth data you entered.

Browse the glossary

Open 12rooms.app/glossary. You’ll see thirty-two entries arranged in three rows.

Row one is the fourteen main stars: Emperor, Mechanism, Sun, General, Harmony, Officer, Treasury, Moon, Wolf, Gate, Minister, Pillar, Slayer, Breaker. Row two is the twelve palaces: Life, Siblings, Spouse, Children, Wealth, Health, Travel, Friends, Career, Property, Fortune, Parents. Row three is six advanced concepts — the four activations (Flow, Drive, Recognition, Friction) and two structural patterns (Triangle and Axis, Slayer-Breaker-Wolf Triad).

Each entry is a roughly seven-hundred-word page in English that doesn’t read like a Google Translate cache. Each ends with a cross-system row — what the Western astrology archetype is, what the closest sixteen-type personality reference is, and a one-sentence note on where the analogy breaks. The naming is hard-coded across the site, including in the chart, including in the cross-system bridge table. That consistency is the point.

Use the bridge table

Open 12rooms.app/glossary/cross-system. This is a single page of thirty-two rows by three systems — ninety-six cells — laying every Zi Wei entry against the closest Western astrology and four-letter reference we could find, with a one-sentence “where this lines up and where it doesn’t” note on each.

This isn’t a synthesis claim. Sixteen-type personality was built to describe cognitive preference; it has no concept of palaces. Western astrology has houses but distributes them differently. The bridge table is an on-ramp, not an equivalence claim. For a reader who already knows their four letters or their sun sign, it’s the fastest way to anchor what’s actually new in Zi Wei before reading the long-form glossary pages.

§3 The decisions behind the naming

A few of the names on the site you’ll have seen before, rendered differently in English elsewhere. Most of those alternative renderings were translations the field has lived with for decades. A few of them carry baggage that doesn’t survive a 2026 read.

七殺, traditionally rendered “Seven Killings,” is the lone-fighter archetype — solitary courage, frontline drive, abruptness. The English “Seven Killings” sounds gangland; it reads like a piece of horror fiction. We use Slayer Star, which captures the same archetype without the abattoir association.

廉貞, rendered in some older English sources as “Prison Star” and in others as “Chastity Star,” is the principled-yet-sensual archetype — discipline meets sensuality, internal tension. Neither “Prison” (which sounds carceral) nor “Chastity” (which loads the archetype with sexual-purity codes that aren’t in the actual meaning) holds the actual scope. We use Officer Star to capture the disciplined-by-duty layer without the prison-cell or chastity-belt connotations.

僕役 in older sources is “Servants Palace.” The colonial-era Orientalism here speaks for itself. Practitioners in the Chinese-speaking field long ago settled on 交友 over the archaic 僕役 to match how people actually live; we render it Friends Palace to match.

福德, traditionally rendered “Happiness Palace,” is the one I find most often mis-read by English readers. The English “happiness” is hedonically narrow — it points at mood. 福德 in Zi Wei covers something wider: baseline mood, yes, but also contemplative life, leisure preference, inherited well-being, the way you spend the hours of the day that aren’t structured by anyone else. Fortune Palace is the rendering that holds that wider scope.

化忌, traditionally rendered “Obstruction Transformation,” is one of the four activations — it marks where a star catches in a chart, where chronic friction lives. The English “Obstruction Transformation” reads as deterministic doom; it sounds like the chart is telling you a thing will go wrong. The actual meaning is closer to this is where you keep snagging on the same thread. We render it Friction Activation to keep the entanglement meaning without the fortune-telling shape.

None of these are settled across English Zi Wei writing yet. There is no committee, no canonical reference text, no widely-agreed translation guide. The site, in part, is an argument for one. Each glossary page explains why we chose what we chose — including which alternative renderings we considered and rejected, and how to map them when you encounter them in older English sources. The work, in other words, is meant to be cross-checkable. Argue with it if you want to. Better arguments are how the field will eventually settle this.

§4 What this site is not

A short list of things 1.0 is not, because some of these are worth being explicit about.

It is not a prediction tool. The chart calculator gives you a snapshot of structural patterns — where the lone-fighter star sits, what the chronic-friction activation lands on, which palaces oppose each other in your specific configuration. It does not tell you what will happen to you. It does not tell you whom you will marry, what your career will be, or when you will be rich. The glossary pages reinforce this in their language; the activations are described as structural, not predictive. Where the site refers to what a chart “points to” or “indicates,” it is always pointing at structural shape, not future event.

It is not a substitute for a human reading. Zi Wei has a thousand-year tradition of practitioner reading, and the live tradition is still where the deepest interpretive work happens. The site exists to give English readers the vocabulary to ask better questions of that tradition, not to replace it.

It is not a cultural authority claim. I am not a master, not an inheritor of a lineage, not credentialed by any Zi Wei school. I am a Taiwanese writer and software developer. The site is an attempt to write down what canonical English Zi Wei could look like in 2026, and to ship a working version so people can argue with it. Other writers and practitioners will, and should, write better versions of this.

It is not final. 1.0 is a starting line.

§5 Why I’m the one building this

The honest answer is: I happened to be in the right position, and I cared.

I’m Taiwanese. I grew up around enough Chinese folk-cosmology vocabulary that I’m not coming at Zi Wei as a complete outsider. At the same time, I’ve spent my working life in English-language software, writing, and product work. Zi Wei in Chinese sources doesn’t have my problem: the vocabulary is settled, the canonical texts are public-domain, the practitioner tradition is still live. The friction was always at the English layer — between someone who has read Co-Star and someone who would benefit from Zi Wei’s structural framework.

I sit awkwardly between the two. That awkward-middle position is why I notice the gap, and it’s also why I can do something about it without being either an underqualified outsider mining a tradition I don’t live in, or an insider whose intended audience is already over the language barrier.

The other honest answer is timing. Large language models are getting good enough at reading the Chinese-language primary sources that the bottleneck on a project like this is no longer translation labour — it’s judgement about which English rendering carries the actual meaning and which carries baggage. That judgement is what the site is, more than anything else.

I’m not under any illusion that I’m the only person who could build this, or that I’ll build the best version. I just happened to be the person who started, and now there’s a 1.0 to argue with. That’s what the site is for.

§6 What comes next, and how you can shape it

The site is live. The chart calculator runs. The glossary is up. The bridge table is up. What matters now is whether English readers find it useful enough to keep coming back.

If you’re curious, here are three things you can do right now:

  1. Try the chart. Open 12rooms.app/chart. Plug in a birth date — yours, someone else’s, a historical figure’s. Walk through the twelve labelled rooms. See what lands where.
  2. Browse the glossary. Open 12rooms.app/glossary. Pick an entry that catches your attention — maybe Slayer Star because the name is unusual, or Friends Palace because you don’t believe the older colonial rendering ever made sense. Read the page. Argue with it if you want.
  3. Subscribe to the newsletter. I write at dvdmaru.substack.com. It isn’t a Zi Wei-specific list — it’s the same place I write about football tactics and political economy. If you only care about the Zi Wei work, those posts will land in your inbox along with everything else; if you also like the rest of it, you’ll get more than you signed up for. I’m one person writing across topics.

And if you have a chart question you’d want a piece written about, reply to the Substack welcome email or DM me on Medium. I’m reading.

Two days ago I published a piece asking what would happen if Western readers met Zi Wei Dou Shu in English worth reading. Today the answer is a URL. The next few months will tell us whether English readers met it back.


메타데이터
post_id
f541026349e2
slug
i-built-the-english-zi-wei-dou-shu-site-i-couldnt-find-f541026349e2
url
https://medium.com/@dvdmaru/i-built-the-english-zi-wei-dou-shu-site-i-couldnt-find-f541026349e2
canonical_url
https://medium.com/@dvdmaru/i-built-the-english-zi-wei-dou-shu-site-i-couldnt-find-f541026349e2
author_url
https://medium.com/@dvdmaru
status
ok
fetched_at
2026-06-09 15:37:30