How Utilaroo builds and checks calculator results
A useful calculator needs more than a correct formula. Inputs, units, boundaries, rounding, stale-result behaviour and explanation must agree from the engine to the page.
1. Define the question
Each tool begins with a narrow statement of what it calculates and what it does not determine. Definitions and units are made explicit before a formula is implemented.
2. Isolate deterministic calculations
Core arithmetic is kept separate from interface code where practical. This allows known inputs and outputs to be tested directly, including zero values, fractional values, invalid ranges, unit conversions and boundary conditions.
3. Verify more than the happy path
Tests cover representative examples, reverse calculations, rounding and failure states. Interactive tools must clear or mark results when a material input changes so an old answer is not presented as current. File tools are checked for type, size, privacy and export behaviour.
4. Preserve precision responsibly
Calculations generally retain full numeric precision internally and round for display. When a whole pack, roll or board is required, the page identifies the deliberate upward rounding. Approximate conversions are labelled rather than displayed as exact facts.
5. Model uncertainty
A single answer is avoided where the underlying performance is inherently uncertain. Solar, battery, heating, cooling and lending scenarios expose user-entered assumptions or low, central and high cases. A simple payback is labelled as such and does not silently include financing, tax, residual value or unentered maintenance.
6. Perform release checks
Before release, Utilaroo runs deterministic engine tests, rendered-route checks, accessibility assertions, navigation and sitemap checks, security and privacy checks, and a production build. A passing test suite supports—but does not replace—manual review of the explanation and assumptions.
Known limitation
No test can guarantee that an entered assumption is suitable for a user’s situation. Results remain estimates derived from the supplied values. Important decisions should be checked against current primary information and, where appropriate, a qualified professional.
