Wasiyyah.
Islamic Will Builder & Faraid Inheritance Calculator
Wasiyyah helps Muslims write a Shariah-compliant will and work out exactly who inherits what under the rules of faraid set out in the Qur'an and classical fiqh. A guided four-step builder covers the testator, the heirs, bequests within the one-third limit, and a formal PDF export. The faraid engine computes every share as an exact fraction — handling hajb (blocking), awl, radd, and the classical special cases including Umariyyatain, Musharaka, Akdariyya and Kalalah — and follows the position of the school you select across Hanafi, Maliki, Shafi'i, Hanbali, Ja'fari, Zaydi and Ibadi. Everything runs on the device: there is no account, no server, and the will is stored encrypted behind the platform keystore. Built with React Native, Expo (SDK 57), a 2,000-line pure-TypeScript inheritance engine covered by a 34-case test suite, encrypted MMKV storage, and full right-to-left support across 10 languages.
What it does.
Guided 4-Step Islamic Will Builder
Faraid Calculator with Exact Fractions
8 Schools of Thought (Madhabs)
Hajb — Blocked Heirs Shown with Reasons
Awl & Radd Handled Automatically
Classical Special Cases (Akdariyya, Musharaka, Umariyyatain)
Bequests with the ⅓ Limit Enforced
Formal Will PDF & Inheritance Statement Export
10 Languages with Full RTL Support
100% Offline — No Account, No Cloud
Encrypted On-Device Storage
Light & Dark Mode
How it’s built.
Write a Shariah-Compliant Will
A guided four-step builder takes you from your own details, to your heirs, to any special bequests, to a finished document. Nothing is left blank by accident — each step shows what is still missing before an export is allowed.
- Testator details: name, date and place of birth, address, identification
- Named heirs with relationship, gender and living status
- Bequests to people or causes, with the ⅓ limit tracked live
- Executor, witnesses and special instructions
- Progress tracking across every step
Calculate Faraid Shares Exactly
Enter the surviving relatives and Wasiyyah computes each share as an exact fraction, not a rounded percentage. The engine handles the cases that trip people up, and explains every result rather than just printing a number.
- Hajb — who is blocked from inheriting, and by whom
- Awl — proportional reduction when fixed shares exceed the estate
- Radd — return of the residue when they fall short
- Umariyyatain, Musharaka, Akdariyya and Kalalah
- The grandfather with siblings, and dhawul arham
Eight Schools of Thought
Choose your madhab and the rules change with it. Where the schools genuinely differ — whether the grandfather blocks siblings, whether radd applies, how a spouse is treated — Wasiyyah follows the position of the school you selected and flags cases scholars dispute.
- Sunni: Hanafi, Maliki, Shafi'i, Hanbali
- Shia: Ja'fari, with the full three-class per-stirpes algorithm
- Also Zaydi and Ibadi
- Scholar warnings surfaced on disputed cases
- Verified against Al-Mughni, Al-Hidaya and Minhaj al-Talibin
Export a Real Document
Produce a formal will as a PDF with legal declarations, executor details and signature blocks — or a detailed inheritance statement showing every asset, every share and the working behind each calculation.
- Formal last will & testament with signature blocks
- Inheritance statement with fractions, percentages and amounts
- Court matter details: suit number, court, applicant
- Choose the PDF's language independently of the app's
- Ready to print, share, or take to a scholar for review
Ten Languages, Private by Design
Wasiyyah speaks the languages its users actually pray in, with proper right-to-left layout — and it keeps their family's details entirely on the device.
- English, Arabic, Urdu, Persian, Bengali, Hindi
- Turkish, Malay, Indonesian and French
- Full RTL layout for Arabic, Urdu and Persian
- Encrypted local storage behind the platform keystore
- Delete every trace of your data from Settings, permanently
Tools used.
- React Native
- Expo (SDK 57)
- Reanimated 4
- TypeScript
- Expo Router
- Encrypted MMKV + Expo SecureStore keystore
- 100% Offline — no server, no accounts
- i18next — 10 locales with RTL
- 2,000-line pure-TypeScript faraid engine
- 34-case test suite on the Node test runner
- expo-print PDF generation
- AdMob + RevenueCat monetization with UMP consent
Perfect for
Common questions.
Yes. Wasiyyah is free to download and use, with a daily allowance of PDF exports (ad-supported). An optional Premium subscription removes the daily cap and the ads. Every calculation feature — the full faraid engine, all eight madhabs, all ten languages — is available on the free tier.
Completely. The will builder, the faraid calculator and PDF export all work with the device in airplane mode. An internet connection is only ever used for ads and subscription validation — never for your will.
Eight: Hanafi, Maliki, Shafi'i, Hanbali, Ja'fari, Zaydi and Ibadi, plus an unspecified default that follows Sunni consensus. The rules genuinely change with your selection — for example, the paternal grandfather blocks siblings under Hanafi but not under Maliki, Shafi'i or Hanbali, and the Akdariyya case applies only in the latter three.
Yes. There are no accounts and no cloud. Your will, heirs, estate values and identification details are stored encrypted on your device, behind a key held in the iOS Keychain or Android Keystore. The only data leaving the phone belongs to the AdMob and RevenueCat SDKs, for ads and purchases. You can permanently erase everything from Settings.
No — and the app says so. Wasiyyah is a study and drafting tool. Inheritance cases can turn on details no calculator can see. Have your will reviewed by a mufti or scholar you trust, and register it with the civil authority in your country if you want it enforced.
The engine is 2,000 lines of pure TypeScript implementing the classical rules, verified against Al-Mughni (Hanbali), Al-Hidaya (Hanafi), Mukhtasar Khalil (Maliki) and Minhaj al-Talibin (Shafi'i), and covered by a 34-case automated test suite that includes the standard textbook cases — Umariyyatain, awl to sevenths, the Minbariyya, Akdariyya per madhab, and estate-conservation invariants across all eight schools.
React Native, Expo (SDK 57), Reanimated 4 and TypeScript — with a dependency-free faraid engine, encrypted MMKV storage keyed from Expo SecureStore, i18next for ten locales with RTL, expo-print for PDF generation, and RevenueCat + AdMob (with UMP consent and ATT) for monetization.
Secure your legacy.
Write a Shariah-compliant will and compute exact faraid shares across eight madhabs — fully offline, in ten languages.