A suite of browser-based calculators and simulators for decentralized finance. Each tool runs entirely client-side, pulls live market data on demand, and keeps your inputs in local storage. No build step, no backend state.
| Tool | What it does |
|---|---|
| Liquidity Pool Calculator | Projects returns, impermanent loss, and out-of-range risk for concentrated liquidity positions. |
| DeFi Yield Calculator | Tracks a portfolio of yield positions and models the fee, investment, or APR needed to hit an income target. |
| Market Cap Comparator | Compares two assets and projects one's price at the other's market cap (spot or all-time-high). |
| PT/YT Strategy Simulator | Models Principal- and Yield-Token outcomes against your own APY and price forecasts. |
| Test Your Luck | A set of probability games — Dice Duel, Penney Race, Designate Choice, and Fish Prawn Crab. |
More tools are in progress; see docs/FEATURE.md for the full status list.
- Frontend: HTML5, Tailwind CSS, vanilla JavaScript (ES modules) — no bundler
- Animation: anime.js (vendored locally)
- Market data: CoinGecko and DefiLlama
- Export: jsPDF and jspdf-autotable (PDF), qrcode
The app is static. To run locally, serve the repository root with any static file server and open index.html:
python3 -m http.server 8000
# then open http://localhost:8000Deploying to Vercel serves the same files and enables the CoinGecko request proxy under api/. See docs/ARCHITECTURE.md for how data fetching and deployment fit together.
Start with CONTEXT.md at the repo root — the core context every contributor (or agent) must read first. It links the rest in reading order. The remaining working docs live in docs/:
CONTEXT.md— read first: the core project context / overviewSKILL.md— the map, hard rules, and reading orderARCHITECTURE.md— how the app is put togetherSTYLE_GUIDE.md— coding conventionsFEATURE.md— feature status: shipped and plannedDATABASE.md— local-storage and API data shapesTODO.md— outstanding work
Licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.
- Share — copy and redistribute in any medium or format
- Adapt — remix, transform, and build upon the material
Under these terms: Attribution, NonCommercial, and ShareAlike.