Skip to content

Repository files navigation

Toolbox

Common calculators, converters, lookups, and everyday utilities — private by default.

License: AGPL v3

Toolbox is a Frappe Framework web app of small, focused utilities at /toolbox. It is web-first and installable as a PWA. Results are deterministic (no AI), calculations run in your browser wherever possible, and data is presented honestly — a fetch time is never shown as a source-update time, and reference data is never labelled "live".

Tools

Calculator Scientific expressions with history
Unit Converter Length, mass, temperature, and more
GST Calculator Add/remove GST; split CGST, SGST, IGST
Financial Calculators EMI, compound interest, SIP, CAGR, break-even
Health & Fitness BMI, BMR, maintenance calories, pace
Timer Timer, stopwatch, and date countdown
World Clock Compare time zones
Currency Converter ECB reference rates, cached for offline
India Business Lookup Search PIN codes and bank IFSC codes; plot PINs on an offline India map
HSN & SAC Lookup Search Indian HSN and SAC codes and descriptions
Weather Current conditions and a public forecast
Dictionary English definitions from WordNet

Data sources

Dataset-backed tools ship their data through a versioned, checksum-verified manifest and show the source's own "last updated" date. Sources and their licenses:

Data Source License
PIN codes Department of Posts, via data.gov.in Government Open Data License – India
Bank IFSC codes Razorpay IFSC (derived from RBI/NPCI) Public domain
HSN & SAC codes CBIC classification, via India Compliance GPL-3.0
Dictionary Princeton WordNet 3.1 WordNet License
Currency rates European Central Bank Reference rates, for information only
Weather forecasts MET Norway Locationforecast 2.0 and Sunrise 3.0 CC BY 4.0
Cities GeoNames cities15000 CC BY 4.0
India map outline geoBoundaries ADM1 CC BY 2.5 IN

Installation

cd $PATH_TO_YOUR_BENCH
bench get-app $URL_OF_THIS_REPO --branch develop
bench install-app toolbox

Development

cd apps/toolbox
yarn install
yarn dev            # Vite dev server
yarn build          # production assets
yarn test           # frontend unit tests (Vitest)
yarn test:e2e       # browser tests (Playwright)

Python tests run from the bench root:

bench --site <site> run-tests --app toolbox

Contributing

This app uses pre-commit for formatting and linting (ruff, eslint, prettier, pyupgrade). Install pre-commit and enable it:

cd apps/toolbox
pre-commit install

License

GNU Affero General Public License v3.0

About

Frappe Toolbox — everyday calculators, converters, and India business lookups (Frappe 17 + Vue 3 PWA)

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages