← Privacy & limits
CURRENT METHOD
Method & limitations
A plain-language description of what the current software calculates and where it stops.
Earlier calculator-method review
MuslimFin reported director-and-board review of the earlier calculator methods. The new hypothetical wealth graph and any signed version containing it still need release QA; that earlier review is not independent Shariah, legal or tax approval. Obtain professional verification before acting on a real case.
What the app provides
MuslimFin Calculators provides supported Islamic-inheritance scenarios and an educational Zakah estimate. It shows inputs, an inheritance breakdown, and a separate hypothetical estate-duty and executor-fee scenario. The cost figures are not assessed bills and do not reduce the displayed heir shares. The inheritance journey withholds heir allocations when the implemented rules cannot safely resolve a scenario.
A qualified Shariah adviser should verify the applicable religious treatment. A South African estate practitioner should verify ownership, claims, estate administration, tax, legal documents and any transfer.
Islamic-inheritance method
The journey begins with the deceased’s settled assets. The user enters assessed debts, funeral expenses, estate costs and a valid bequest to non-heirs, then records surviving family information.
The current shared engine covers supported spouse, child and parent scenarios and includes proportional awl adjustment where applicable. Displayed group amounts are apportioned to cents so they reconcile with the distributable estate.
Ruleset
2026-09-10
Core references
Qur’an 4:11, 4:12 and 4:176
Earlier method review
Director-reported
The implementation was source-reconciled with the public website calculation bundle last modified 2026-09-17. Reconciliation and software tests are separate from the earlier director-reported review.
When inheritance stops for review
No heir allocation is issued when the case includes, or may include:
Unsettled joint-estate, accrual or other ownership claims.
Grandparents or sibling combinations outside the verified supported boundary.
Grandchildren, pregnancy, missing or unlisted heirs.
Disputed eligibility, incomplete information or conflicting entries.
Bequests to heirs or an excessive or disputed bequest.
An unresolved remainder (radd) or another result that does not reconcile.
Hypothetical wealth-growth graph
The graph starts with the gross total of the five inheritance asset entries: property, savings, vehicles, investments and business assets. It does not use the net distributable estate or an heir's share. It appears only for a supported result.
MuslimFin's owner supplied real-return targets of CPI + 2%, CPI + 3.5%, CPI + 5%. This illustration assumes 6% annual inflation rather than reading current CPI. The nominal rate is calculated as (1 + assumed inflation) × (1 + selected real return) − 1. It compounds every entered gross asset at one smooth rate, including cash and vehicles; it is not a return forecast.
At years 0, 5, 10, 15, 20, the personal line shows projected gross assets remaining in the estate. The second line holds today's entered gross amount in the estate and hypothetically places all future gross growth outside it. The “today's money” option discounts both lines by assumed inflation. The difference is not a trust benefit, tax saving, Takaful need or heir buyout.
No structure or transfer is created or validated here. Costs, duties, capital gains tax, legal and Shariah validity, control, changes in asset mix, deposits, withdrawals, volatility and investment fees are not modelled. Obtain qualified advice before treating any amount as an estate-planning outcome.
Graph model
2026-10-11-gross-exposure-v1
South African tax, fees and liquidity
The result shows a simple cost scenario, not a tax return or fee quote. It treats all gross assets you entered as the starting value for both estate duty and the executor fee, although the real amounts can use different asset values. The scenario assumes no extra estate-duty property or deductions, no unused allowance from a previously deceased spouse, no income earned after death and the standard executor fee rather than a different fee in a will. For a smaller estate, the Master may appoint a representative instead of an executor, so this fee may not apply. The VAT-inclusive figure applies only if the executor or agent is VAT-registered. A surviving spouse alone does not establish a tax deduction.
The figures are not assessed estate duty, an agreed executor fee or a calculated capital gains tax bill. They are not taken off the Faraid shares. If you have already entered a confirmed tax or fee among debts and costs, it is already included in the inheritance result; do not deduct it again.
A real estate may need accessible cash for assessed debts, taxes, administration costs and amounts owed to heirs. The result can help you consider that question, but it does not calculate a cash shortfall, Takaful need or the cost of settling another heir’s interest in an asset. An estate practitioner and tax professional should assess the actual amounts before any distribution or filing.
For the detailed rules, see these official sources (checked 13 October 2026). External links do not attach calculator entries.
Zakah method
Included assets − eligible liabilities − impermissible income already included = net assessed wealth
Net assessed wealth cannot be below zero. When the user confirms the lunar-year (hawl) condition and net assessed wealth reaches the selected nisab, the app estimates 2.5% of net assessed wealth.
If hawl is unknown, the app shows only a conditional estimate. If hawl is marked not yet met, a zero result reflects that selection and is not presented as a general exemption.
The user selects either 87.48 grams of fine gold or 612.36 grams of silver. When automatic references are available and connected, the screen attempts to fill both rand-per-gram prices and a valuation date from a public Gold API reference. The source and each metal’s quote time are shown. An unavailable, stale or invalid reference leaves the prices for manual entry; a user may also edit the price, date and source. The calculation uses the displayed values, not a hidden quote. An indicative spot quote does not independently verify the value of locally held gold or silver, and automatic retrieval does not back-price historical valuation dates.
Jewellery, investments, retirement arrangements, trusts, partnerships, farming, receivables and debts can depend on ownership, access, intention and scholarly interpretation. Harvest produce is held for separate ushr review rather than charged at the ordinary annual 2.5% rate.
Zakah ruleset
2026-09-10
Engine version
2026-09-10
Earlier method review
Director-reported
One calculation source, separate releases
The standalone app and canonical website route consume the same versioned calculator package. A calculation-rule change must update the shared source, add or update regression fixtures, and pass cross-platform consistency checks.
A website release does not automatically update an installed iPhone or Android app. Native corrections still require a reviewed store update, and a material issue may require pausing the website or store rollout while that update is reviewed.
App version 0.1.0 · Inheritance ruleset 2026-09-10 · Zakah ruleset 2026-09-10
Before acting on a result
Check every entry and assumption. Do not use this app alone to prepare a will, decide tax, settle civil ownership, answer a disputed heir question, or transfer and distribute assets.