South African public-data and news desk
# Public Pulse ZA
Experimental South African public-data desk.
Public Pulse ZA makes scattered public information easier to scan: population markers, public finance watchpoints, cautious SAPS crime-stat notes, service notices, and current public-channel news video.
The deployable product is intentionally small. It is a Vercel-hosted Next.js app with one public page, a health endpoint, and a YouTube RSS video feed. It does not ship the old server stack, operational map, scraped crime feed, classifier, or command interface.
## What Works
- newsroom-style public data desk
- restrained source labels: cited, estimate, queued, source link and guardrail
- estimated birth/death counters with clear non-official wording
- curated public release shelf
- YouTube RSS feed for SABC News, Newzroom Afrika, eNCA and News24
- muted video autoplay with playlist continuation
- Vercel-root workspace build
## Boundaries
Public Pulse ZA is not an official source, police tool, emergency service, government product, or investigative platform.
Numbers should only become stronger when the project has:
- source URL
- source institution
- period covered
- calculation method
- last checked date
## Run Locally
```bash
npm install
npm run dev
```
Open `
localhost`.
## Release Check
```bash
npm run typecheck
npm run lint
npm run build
```
## Vercel
- Framework preset: Next.js
- Build command: `npm run build`
- Output directory: `frontend/.next`
- Required environment variables: none
## License
MIT. See LICENSE.