Iwacu

Inviting and Connecting

Bringing a family member into your tree, and connecting two separate trees maintained by different people.
This is the summer 2026 guide.
Some of it has changed since. A new guide (v1) is being written.

Inviting and Connecting

Inviting a family member

A person invitation ties the new member to a specific record in the tree.

  1. Open a family panel: click a family card, or run family open <alias>.
  2. Go to the Members tab.
  3. Click 🔗 next to the person you want to invite.
  4. Share the generated link with the right person by any trusted channel.

When they open the link and accept, they join as that specific person. They get access to the family group chat and can receive direct messages from other connected members.

Family invitation

Lets someone join a family cell without being assigned a specific record yet — useful when you want to chat before completing their entry.

  1. Open the family panel → Invite tab.
  2. Share the link.

You can assign them to a specific person record later.

Each invitation link is scoped to one family cell. A link for the Kamanzi family cannot be used to join the Mugabo family.

Connecting two trees

Use this when you have found a cousin who maintains their own separate tree and you share a common ancestor.

What connecting does

After connecting, a bridge appears in both trees as a dashed line between the shared ancestor in your tree and the corresponding person in your cousin's. You can open a direct message thread with your cousin from their person record in your tree.

The two trees stay independent — you keep yours, they keep theirs. Only the bridge and the message channel are shared.

How to connect

  1. Run tree merge or click Connect Trees in the toolbar.
  2. Choose the relationship direction:
    • Lateral — you and the other person are at the same generation (cousins).
    • Ancestor — the other person's tree extends further back.
    • Descendant — your tree extends further back.
  3. One person taps Show QR, the other taps Scan QR.
  4. Both sides confirm the shared person. Tap Connect.

The bridge is established on both sides.

Setting up several trees ahead of time — before handing devices to their real owners — doesn't need the dialog at all. Run tree link on the source tree, then tree connect <link> <personAlias> on the tree you're bridging it to. Both are ordinary terminal commands, so the whole setup can be scripted.

Desktop app and devices