Zakat Kit

Host your own

Run Zakat Kit for your family, mosque or workplace.

Zakat Kit is open source and is one app: the calculator, the business tools and accounts. Host it yourself and every account lives on infrastructure you control.

A family

Everyone works out their own zakat on a copy the family trusts. Figures stay on each person's device unless they make an account.

A mosque or zakat committee

Give your community a calculator under your own name, alongside how and where to pay through you.

A business or workplace

Staff and owners use the purification audit and business zakat on a private copy.

What you need

Somewhere to run it

Any host that runs Next.js on Node 20 or later. A free tier is enough for a family or a community.

A database, for accounts

Only if you want accounts: a MongoDB database. Without one, the calculator still works fully, device-only.

One secret

A long random string, ACCOUNT_SECRET, if you turn accounts on.

Set it up

  1. 1

    Get the code

    git clone https://github.com/bytheitc/zakat.git
  2. 2

    Deploy it

    Deploy the repository as a Next.js app. With no settings at all it runs device-only: the calculator, al-Fitr, the monthly plan and the business tools all work.

  3. 3

    Turn on accounts (optional)

    Set these where you deploy (see .env.example):

    MONGODB_URI=mongodb+srv://…        # your own database
    ZAKAT_DB_NAME=zakat_kit
    ACCOUNT_SECRET=<a long random string>

    Accounts store only ciphertext: figures are encrypted in each person's browser before they are saved, so even you, running the server, cannot read them.

  4. 4

    Share it

    Send people the address. They can use it without an account, or make one to keep their calculations on every device.

Before you share it

  • Keep the line that says it is a calculator, not a ruling. If your scholars follow particular positions (silver or gold nisab, for example), say so on your copy.
  • Tell people plainly that a forgotten password means their encrypted backup cannot be recovered, by them or by you.
  • Back up the database if accounts are on.

Need a hand?

Open an issue on GitHub and the maintainers will help.

Ask on GitHub