Clone bottled mineral waters from distilled (or known-source) water and food-grade salts. Waterforge is a static, client-side web app: pick a target profile, set your source water, toggle the salts you own, and get a precise, batch-scaled recipe. Install it to your home screen and it works offline, at the counter, with no connection.
Try it: waterforge.app
Waterforge takes a named target mineral-water profile, subtracts what is already in your source water, and computes the exact salt additions (in grams, scaled to your batch size) needed to hit it. It also shows you the sulfate:chloride ratio, TDS, and charge-residual readouts, and warns when any salt approaches saturation so you know the recipe will actually dissolve.
The solver uses non-negative least-squares (NNLS) with exact stoichiometry — not rules of thumb — so results are reproducible anywhere you can get distilled water and food-grade salts.
Who it is for: homebrewers and water hobbyists who want to match a specific drinking-water profile precisely. It is not a mash-pH or brewing-salts tool; see CONSTITUTION.md for non-goals.
Requirements: Node 22 (check with node -v).
git clone https://github.com/cacack/waterforge.git
cd waterforge
npm install
npm run dev # dev server at http://localhost:5173Other useful scripts:
| Script | What it does |
|---|---|
npm run build |
Production build to dist/ |
npm run preview |
Serve the dist/ build locally |
npm run test |
Run the Vitest test suite (engine unit tests) |
npm run typecheck |
svelte-check + tsc — full type-check |
npm run lint |
ESLint + Prettier format check |
npm run format |
Auto-format all files with Prettier |
| Document | What it covers |
|---|---|
| CONSTITUTION.md | Mission, audience, principles, non-goals |
| USAGE.md | How to use the app (intended user flow) |
| CONTRIBUTING.md | Dev setup, conventions, testing, license terms |
| ROADMAP.md | Where the project is headed |
| docs/architecture/overview.md | Stack, module boundaries, data flow |
| docs/decisions/ | Architecture Decision Records |
| docs/guides/chemistry.md | Chemistry background and unit conversions |
| docs/guides/reference-data.md | Reference data and profile sources |
| docs/operations/ci-cd.md | CI/CD pipeline and deployment |
| docs/operations/release.md | Release runbook (cut, tag, publish) |
- A question, or unsure what a readout means? Open a question issue.
- Found a bug or a wrong number? File a bug report — a shared recipe link (the share button in the app) captures the exact inputs.
- Want a water added to the library? Open a profile request with a source for its mineral analysis.
Where the project is headed is in ROADMAP.md.
Waterforge uses a split license:
- Code — GPL-3.0-or-later.
- Profile data — CC-BY-SA-4.0. The data is an independently-sourced compilation (each profile cites its own source); CC-BY-SA-4.0 is the project's copyleft choice over it, and derived data must be shared under the same license. The recipe method is credited to Martin Lersch (Khymos).
This keeps the project free and copyleft, faithful to the freely published source method it builds on.