Skip to content
Projects

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.

How these counts are measured

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 & Apps

README.md

Original

KivaLens

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 from reference/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's application.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