ProjectsApps
Apps, TypeScript
Alex's Craft Calc
Alien Purple soap and candle calculator: dual-mode recipes, a craft wiki, Windows desktop and Android, fully local math.
v1.1.1 released
Soap + candle math in one beautiful offline app.
Cold-process lye · wax & fragrance · full craft wiki · Windows · Android · PWA
Toggle Soap ⇄ Candle in one installable app. Press F1 anytime for the Craft Wiki — app help plus a real encyclopedia of oils, waxes, process, and safety.
Built for makers who weigh twice and pour once. All math stays on your machine.
✧ Highlights
| Soap | 51 oils/butters · dual weight/% entry · NaOH/KOH · superfat · water 3 ways · FA quality profile · 23 additives (incl. citric lye compensation) |
| Candle | 10 wax profiles · vessel presets · FO load guidance · dye estimate · wick starting points |
| Wiki | 100 articles (static + full oil/wax encyclopedia) · search · deep-links from calculators · phone Back stack |
| Recipes | Save / load / share portable JSON · library backup · copy · print batch sheets |
| Ship | Tauri Windows EXE/MSI · Capacitor Android APK · installable offline PWA |
Soap calculator
- 51 oils & butters with industry-standard NaOH SAP values + craft encyclopedia blurbs
- Weight of oils: unit tabs g · oz · lb (default oz) + dedicated Total oils ceiling
- Dual entry: weight and % always editable per oil — edit one oil only; others stay put
- Total oils is the recipe ceiling (never auto-rewritten when you type oil weights)
- Results unlock when oil % = 100% and weights sum to Total oils
- Helpers: Scale weights to total · Apply % to weights
- NaOH (bar) or KOH (liquid) — KOH from NaOH via molecular-weight ratio
- Superfat % with live lye adjustment
- Water methods: % of oils · lye concentration · water discount
- Fragrance % of oils
- Fatty-acid quality profile — live breakdown with good-range status
- Additives & add-ins — clays, oats, milks, salts, botanicals, chelators, colorants, antioxidants (usage % + phase + cautions; citric acid auto-compensates lye)
- Weighted iodine & INS + hardness body hint
- Presets: Custom · Castile-ish · Everyday Bar · Creamy Shea · Palm-free · Luxury Butter
- Custom recipe notes · Save / load / delete · Load portable JSON · Share · Copy · Print
- Per-oil wiki deep-links (ⓘ)
Candle calculator
- 10 wax profiles (soy, para-soy, coconut blends, beeswax, paraffin, palm, gel)
- Vessel presets (tins, jars, pillars, tealight…) with diameter hints
- Per-vessel or total wax entry
- Fragrance load % with min/max guidance + in-range pill
- Dye block estimate · wick starting-point by jar diameter
- Pour / melt temperature notes
- Units: g · oz · lb (converts wax weights)
- Save / load · Copy · Print · Load / Share (same portable format as soap)
Craft Wiki (F1)
- ~100 articles: app manual + soap craft + candle craft + safety + reference + every oil & wax
- Categories, search, tags
- Keyboard: F1 toggle · Esc close · Ctrl+/ focus search
- Deep-link from calculators into the matching oil/wax page
- Phone: one full page at a time — ← All articles, Esc, or system Back returns article → list → calculator (does not exit the app first)
Recipe save / load / share
| Action | What it does |
|---|---|
| Save | Store or update the active recipe in the local library |
| Load | Friend’s .alex-soap.json / .alex-candle.json or full library backup → merges into Saved |
| Share | OS share sheet on phone when available; otherwise downloads the portable file (right-click / long-press Share for full library) |
Format: alex-craft-calc-recipe v1 (round-trips cleanly; older export files still Load).
Name collision without an active slot → confirm before overwrite.
App shell
- Dark craft UI with brand art
- Soap ⇄ Candle mode toggle (remembered)
- Installable PWA (Windows desktop + phone home screen)
- Works offline after first load
- Toasts, floating help, mobile-safe layout
- No account, no cloud — all math runs locally
Quick start
Windows (everyday)
- Double-click
START.batin this folder
(first run builds if needed, then opens a local server) - Browser opens http://localhost:4173
- Optional: Chrome/Edge → Install Alex's Craft Calc for a desktop app window
- Press F1 for the craft wiki
Dev
npm install npm run dev
Production web
npm run build npm start
Tests
npm testMobile (PWA)
- On the same Wi‑Fi, open
http://<your-pc-ip>:4173from the phone
or deploy thedist/folder to any static host / tunnel. - Safari/Chrome → Add to Home Screen
- Tap ? or F1 / Wiki for the knowledge base.
Releases (CI)
Installers are built on GitHub, not on your laptop.
# bump version in package.json + src-tauri + android/app/build.gradle, then:
git tag v1.1.1
git push origin v1.1.1| Workflow | When | Output |
|---|---|---|
| CI | PR / push to main |
npm test + typecheck |
| Release | tag v* (or manual dispatch) |
Windows MSI/NSIS + Android debug APK on the GitHub Release |
Re-run a tag build anytime: Actions → Release → Run workflow (pass the tag, e.g. v1.1.1).
Local native builds (optional)
Only if you need to debug packaging offline.
Windows (Tauri) — Rust + MSVC Build Tools + WebView2:
npm install npm run tauri:build
Android (Capacitor) — JDK 21 + Android SDK:
npm run android:apk
See releases/README.md for paths and notes.
Project layout
src/ React UI + calc engines + F1 wiki
src-tauri/ Tauri 2 Windows desktop shell
android/ Capacitor Android project
public/ Icons, brand mark, PWA assets
releases/ Local packaged EXE / MSI / APK notes
START.bat One-click web launcher
Safety
- Always add lye to water, never water to lye. Wear PPE.
- Verify SAP values with your oil supplier COA.
- Fragrance limits vary by IFRA and wax brand — test burn candles.
- This tool is for craft planning, not lab certification.
Changelog
See CHANGELOG.md — current release v1.1.1.
Downloads
GitHub Releases: v1.1.1
Built for Ahmi · Alex's Craft Calc v1.1.1 · local-first craft math
"Hope this helps" - Ahmi
This comes from the project's README. Read it on GitHub