Matokeo — a friendly UI for Tanzania's NECTA CSEE 2025 exam results
# Matokeo · CSEE 2025
A friendly, fast UI on top of Tanzania's official NECTA CSEE 2025 examination
results. The official site publishes results as raw 1990s-style HTML tables —
this app fetches those same pages live, parses them in the browser, and
presents them with search, filters, charts and shareable result slips.
**Live:**
necta-wrapper.vercel.app
## Features
- Search all ~6,700 examination centres by name or number (virtualized
infinite scroll, alphabet filter)
- Paste a full candidate number (e.g. `P0332/0001`) to jump straight to a
report-card-style result slip with a shareable URL
- Per-centre division distribution bar with girls/boys toggle
- Candidates table with filters (sex, division, subject, grade in subject)
and sortable headers
- Subject performance charts, including a "girls vs boys" compare mode with
per-subject verdicts
- Insights: top-of-the-centre leaderboard and aggregate histograms by sex
- Aggressive caching (react-query + localStorage) — results are static once
published, so repeat visits are instant
## Stack
React 19 · Vite · TypeScript · Tailwind v4 · shadcn/ui · TanStack Query +
Virtual · react-router. No backend — the NECTA pages are fetched through a
proxy rewrite (Vite dev proxy locally, a `vercel.json` rewrite in production)
because the source site doesn't send CORS headers. Source pages are
windows-1252 encoded and decoded manually.
## Development
```sh
bun install
bun run dev
```
## Disclaimer
Not affiliated with NECTA. Data is reproduced as published at
onlinesys.necta.go.tz — always verify against the official source.
## License
The Unlicense — do whatever you want with it.