nuclearspike/kivalens
nuclearspike/kivalens has 49 GitHub stars and 21 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:34 UTC. Last push 2026-11-14.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
KivaLens — advanced loan-search for Kiva.org micro-lending. Vite + React 19 + TypeScript.
Web & AppsREADME.md
OriginalKivaLens
KivaLens — the advanced loan-search tool for Kiva.org micro-lending — rebuilt on a modern stack with zero Bootstrap.
The previous version — the 2015 app (React 0.14 + Reflux + Bootstrap 3 /
Bootswatch Flatly + Browserify) — is preserved on the
legacy branch and the v1-legacy tag. This rebuild
reproduces its rendered look and behavior using:
| Layer | 2015 app | This app |
|---|---|---|
| Build | Browserify + Babel 5 + gulp | Vite 8 |
| Language | ES2015 JSX | TypeScript 5.9 |
| UI runtime | React 0.14 | React 19 |
| State | Reflux stores | zustand (+ immer) |
| Routing | react-router 1 | react-router-dom 7 (hash router) |
| CSS framework | Bootstrap 3 / Flatly + SCSS | None — hand-rolled src/ui/ + src/styles/base/ |
| Charts | Highcharts (vendor bundle) | recharts |
| Selects | react-select v1 | react-select v5 (restyled to v1) |
| Sliders | react-slider | rc-slider (restyled) |
| Server | Express proxy server | Node server (server/prod.mjs) + Vite dev plugin |
No Bootstrap, same pixels
src/ui/— hand-written components exposing the subset of the react-bootstrap API the app uses (Grid, Button, Form, Card, ListGroup, Badge, Alert, Tabs, Modal, Dropdown, ProgressBar, OverlayTrigger/Popover, Navbar/Nav). No runtime dependencies.src/styles/base/— a hand-written CSS base layer that reproduces the Bootstrap 3 Flatly 3.3.5 rendering (buttons, forms, tabs, panels, alerts, modals, badges, progress bars, grid, utilities). Values were lifted fromreference/flatly-3.3.5-reference.css(kept for reference only — never imported).src/styles/main.scss— the KivaLens green theme, ported from the 2015 app'sapplication.scss.
Run
npm install
npm run dev # http://localhost:5173 (or --port)
On startup the dev plugin downloads all fundraising loans from Kiva's API and
serves them at the same /api/ endpoints the production KivaLens server uses
(first page-load may briefly use the Kiva-direct path while data is prepared).
npm run build # tsc + vite build
npm run lint
Production
The same API the dev plugin provides is served in production by a tiny, dependency-free Node server, so dev and prod share one implementation:
| File | Role |
|---|---|
server/klCore.mjs |
All the logic — Kiva download, KLS batch packaging, periodic refresh, and the /api/*, /graphql, /proxy/* request handlers. Node builtins only. |
server/klDevPlugin.ts |
Thin Vite plugin that mounts klCore into vite dev. |
server/prod.mjs |
Production HTTP server: serves the built dist/ SPA + mounts klCore. Listens on $PORT. |
npm run build # produces dist/
npm start # node server/prod.mjs — serves dist/ + the API on $PORT
The server upgrades HTTP→HTTPS behind a TLS-terminating proxy
(x-forwarded-proto), sends an A+ set of security headers (CSP, HSTS,
nosniff, frame-deny, referrer + permissions policies), gzips the loan batches,
refreshes the dataset every 10 minutes, and proxies Kiva's getGraphData and
the A+ Google-Sheet through /proxy/* with the header recipe Kiva's WAF
requires (no browser User-Agent). It has zero runtime dependencies (Node
builtins only).
Releasing
Rules for changes and releases are in AGENTS.md. In short:
node scripts/gate.mjs <commit> # build a clean copy and run every check
node scripts/deploy.mjs <commit> --dry-run # everything but the pushes
node scripts/deploy.mjs <commit> --yes # push, wait for the live build, check the live site
node scripts/smoke-live.mjs # check the live site's features at any time
node scripts/record-upstream-fixtures.mjs # re-record Kiva's and Google's answers for the tests