~/notes/mirath.md — zsh

← cd ~

$cat ~/notes/mirath.md

2026-08-06 · mirath/

Inheritance, worked out in the open

When someone in a Muslim family dies, their estate has to be divided among the heirs. It is a real requirement, it comes at the hardest possible time, and it is where a lot of family conflict starts: who is owed what, and on whose authority.

The rules themselves are unusually exact. The Qurʾan fixes the shares — a half, a quarter, a sixth — and the classical scholars spent centuries working out what happens when those shares collide. What is often missing in the moment is a reference everyone can look at together, with authentic sources attached. That is the idea behind Mīrāth.

A number on its own asks you to take it on trust, so the calculator shows its working. Every share comes with the rule that produced it, the arithmetic behind it, and the verse or hadith it rests on, one click away under Why. Relatives who inherit nothing are listed too, with the reason they are barred. When a family disagrees, everyone is at least looking at the same reference, with the same sources.

The schools disagree, so the calculator does too

The four Sunni schools mostly agree, but not entirely: the grandfather against the brothers, the return of a surplus, the famous donkey problem. Switching schools changes the arithmetic exactly where they differ, and the reason is given next to the result. The classical problem cases — al-ʿUmariyyatān, al-Akdariyya, al-Mushtaraka — are built in, so you can watch the well-known ones resolve.

Exact fractions, not decimals

When the fixed shares add up to more than the whole estate, ʿawl raises the base so every heir is reduced in proportion. Floating point can quietly lose that, leaving shares that no longer sum exactly to the whole. Mīrāth keeps everything as exact fractions, so a base of 24 raised to 27 stays exactly 27.

In the language people speak at home

It reads in English, Urdu and Hindi. Urdu runs right to left in Nastaliq, which needed care: letter-spacing breaks the joins between letters, and splitting one word across two styled spans breaks its shaping. That mattered more than it sounds. This is a page about family, and it should read naturally to the people using it.

What it isn't

It is a study aid, not a ruling. It knows nothing of who predeceased whom, whether a marriage is established, or debts nobody entered. Any real distribution should be confirmed by someone qualified.

Open the calculator →

$