A lawyer or trainee works out a dower (mahriyeh), an inheritance share or blood money several times a day. If the calculator gives a number with no source, if its coin price is last month’s, or if you cannot show the output to anyone, trouble follows. We built VakilYar for this. This article explains three of its design decisions.
What is usually wrong with legal calculators?
| Common flaw | Why it is risky | Decision in VakilYar |
|---|---|---|
| A number with no legal article | You cannot show where it came from | The legal article and source print next to every figure |
| Built-in rates | Coin prices and inflation indices change; a stale number slips silently into a case | The app deliberately ships no rates; you enter them and the source appears in the report |
| Output only on the phone screen | It cannot be printed or tracked | A right-to-left Persian PDF with a tracking number, marked “unofficial document” |
| Needs internet and an account | Case details go to a server | Offline, no internet permission and no account |
- Choose a calculation
Mahriyeh, inheritance split or blood money.
- Enter the rates
You type the coin price, inflation index and full blood money with their source.
- Result with sources
Each figure with its legal article and a short note.
- PDF output
A right-to-left report with a tracking number, as an unofficial document.
Why doesn’t the app ship the coin price and inflation index?
Because these rates change every year and sometimes every month. If the app had its own number and it went stale, the user would not notice and a wrong figure would enter the calculation. When you enter the number yourself, the responsibility for the source is clear, and the source prints next to the figure in the report. It takes a little more time, but it prevents a silent error.
Where does the legal basis come from?
Each figure carries its article. For example, mahriyeh goes back to article 1082 of the Civil Code and inheritance to articles 861 to 949. You can read the official text of the laws in the National Portal of Laws and Regulations and the Parliament Research Center’s database and compare it with the app’s output. The app does not replace reading the law; it only ties it to the calculation.
How does the court-date reminder work?
This tool unlocks with a subscription. You record hearings and deadlines for each case and get an alarm before they fall due. The alarm is built on Android’s own alarm system and survives a restart. The three-way calculator (mahriyeh, inheritance and blood money) is always free.
Where should you not rely on VakilYar?
- VakilYar is a calculator, not legal advice. Its output is a machine estimate and an “unofficial document”, not a substitute for an official court expert or a lawyer.
- The legal basis and the dates are always set by the court.
- Inheritance covers only the first class (parents, children and spouse). A grandchild’s share, hobweh, blood-money inheritance and the second and third classes are not in this version and the app warns you at that point.
- Laws and rates change; you are responsible for entering the correct, current rate.
- Android 7 and later only; there is no iPhone version.
How do I get started?
- Download the free demo from the VakilYar page and allow installs from outside a store if Android asks.
- Read the terms of use to the end and accept them.
- Open mahriyeh, inheritance or blood money in the legal calculator and enter the rates with their source.
- Check the result against the text of the law and your own manual calculation.
- For more tools (late-payment damages, alimony, inheritance tax, court fees, deadlines, reminders), ask for a subscription from the contact page.
More single-purpose offline apps are in the case study of four Persian offline apps. To choose between a native app and Flutter, read Flutter or native.
Frequently asked questions
How reliable is an online mahriyeh or inheritance calculator?
You cannot rely on any calculator that does not show the legal article and the source of the rate next to the number. VakilYar prints the basis next to each figure and takes the rates from you, but its output is only an unofficial estimate.
Why doesn’t VakilYar ship the coin price and inflation index?
Because these rates keep changing and a stale number would slip silently into a case. You enter the rate with its source, and the source prints in the report.
Is VakilYar’s output valid in court?
No. The output is a machine estimate and an unofficial document, not a substitute for an official court expert or legal advice.
Do case details go to a server?
No. The app has no internet permission and everything stays on this phone.