How Ahnenwerk works

Getting started

When you launch Ahnenwerk you land on the setting picker. A setting is one world — one tree. Create a new setting, open an existing one, or load one of the three built-in examples (the British Crown, the Egyptian Gods, Julio-Claudian Rome) to see a finished tree.

Everything is stored locally in your browser and saved automatically as you work — there is no account and nothing is uploaded. To move a world between devices, or to back it up, use Import / Export (JSON). Deleting a setting is gated behind typing DELETE so you can't lose a world by accident.

The event model

This is the one idea that makes Ahnenwerk different. People are thin records — a name and a few optional fields. Every relationship lives in an event. A birth records the child and its parents; a marriage records the partners; a death closes a life. The tree you see is derived from those events every time anything changes, so it's always consistent. Edit or delete an event and the graph re-derives on the spot.

You add events from a person's side panel (click a person to open it) via + Event, or by editing existing ones in that person's event list. The twelve event types are: birth, death, marriage, divorce, adoption, fusion, defusion, body-swap, reincarnation, possession, succession, and a free-text custom event.

Births & parents

A birth event names the person being born and their parents. Parents are optional and unlimited: zero parents (a root of the tree), one, two, or more than two for multi-parent births. A parent can be an ordinary person or an entity — a non-human that still belongs in the lineage (a god, a relic, an AI). Entities are drawn with a distinct dashed card so they read as "not a person."

Adoption is a separate event that adds a parent–child link without claiming a biological birth, drawn as its own dashed line.

Marriages, divorce & unions

A marriage joins two people; their shared children hang beneath the couple from a central junction. Remarriages are fine — a person can have several partners over time, and the layout keeps each couple together. A divorce event marks a marriage as ended; the connector is restyled (a slashed, dashed double line) rather than removed, so the history stays visible.

Lifespans & multi-phase lives

A person's dates come from their events: a birth opens a life and a death closes it. But a life can have several phases — if a character is born, ends in a fusion, is later restored by a defusion, and dies again, every birth→end phase is shown (for example -18 – 10 · 43 – 78). A fusion or defusion that ends a person counts as an end-of-phase, the same as a death.

Titles & lines of succession

A title is a thing that passes down a line over time — a crown, a high office, a hereditary rank. Create titles in the Titles panel (name, optional house, optional note, an optional line color). The list of who held it when is derived from succession events, never stored by hand.

A succession event acts on one title with one or more holders and an action:

• hold — these people become the holders (replacing anyone not relisted).
• cohold — add holders alongside the current ones (co-monarchy, disputed claim).
• end — remove these holders (an abdication; vacancy until the next hold).

A holder's death, fusion, or defusion automatically ends their tenure — but never starts one, so a death leaves the title vacant (an interregnum) until an explicit hold. Overlapping holders are allowed. On the canvas a title draws as a single colored thread linking its holders in time order, with a small colored pip on each holder's card; a per-title toggle shows or hides the whole thread and its pips at once. Select a title in the panel to see its full ordered reign list.

If a person has a regnal name set (a throne name), it shows by default; the name views cycle regnal → regular → nickname.

Exotic relationships

These are the cases ordinary genealogy tools can't represent. Each is its own event type with its own connector style.

• Fusion — two or more inputs merge into one output. The inputs end (they don't die and aren't deleted), so they can be brought back later.
• Defusion — splits a fused person back into its outputs. Any output a fusion had previously ended is restored to the tree in its original place; outputs that never existed before are created one generation below.
• Body-swap — two characters exchange bodies; the link records the swap.
• Reincarnation — a directional soul link from a past life to a new one (drawn from the earlier life forward).
• Possession — a directional link from a possessor to the host whose body they seize, with a releasable interval; the possessor may be an entity.

On large trees, fusion / defusion / body-swap arcs draw only when you hover, select, or focus a node, so dense canvases stay readable.

Moving around the canvas

• Pan by dragging the background; zoom with the wheel. Zooming out steps through levels of detail: full cards → names → family blocks.
• Click a person to select them and open the side panel; double-click to enter focus mode (their ancestors and descendants, everything else dimmed).
• Relate (side panel): pick a second person and Ahnenwerk highlights and spells out the shortest relationship chain between them.
• Collapse / expand a subtree from the side panel to tuck away branches you're not working on.
• Timeline (bottom center): scrub to a year — the unborn hide, the dead and ended dim, later events vanish, and positions stay put.
• House filter (toolbar): dim everyone outside one family while keeping married-ins bright.

Layout & pinning

Ahnenwerk lays the tree out automatically — generations, couples kept together, parents centered over their children, special links routed around cards. Auto-arrange re-runs that layout for the whole tree (or just a selection).

To place someone by hand, just drag them — that pins the node, and it stays exactly where you put it while the rest of the tree flows around it. Unpin from the side panel to hand the node back to automatic layout. A lock toggle freezes the layout so nothing moves by accident, and a fully manual mode turns auto-positioning off entirely so every node stays where it sits.

Houses, colors & connections

Give a person a house / family and their card takes on that house's accent color (and houses drive the far-zoom blocks). Set house colors in the Houses panel and a title's color in its edit form; both are saved with the setting.

The connections legend lets you toggle each link type on or off — turn off marriages, or fusions, or any title thread, to declutter while you work. The edge vocabulary: solid = lineage · double brass = marriage (slashed = divorce) · dashed = adoption · converging ember = fusion · dotted arc = body-swap, with reincarnation and possession drawn as their own directional links.

Export

From the toolbar you can export your world three ways:

• JSON — the complete setting; re-import it anywhere, back it up, or hand-edit it.
• Markdown — a per-person genealogy section, ready to drop into a worldbuilding wiki.
• PNG — an image of the whole tree (rendered at full resolution) or just the current view.

Because export is one click and the format is plain, your data is never held hostage — you can leave Ahnenwerk at any time and take your whole world with you.

Keyboard shortcuts