Skip to content

wulfsagedev/civaccount

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

238 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CivAccount

See exactly where your council tax goes — for all 317 English councils.

civaccount.co.uk · Free · Independent · .gov.uk data only

Live   License: MIT   Data licence   Next.js   TypeScript


What it does

CivAccount turns 15,000+ scattered data points across 317 English councils' budget documents into one clean, accessible website. Look up your council, see your tax bill, see where every pound goes, compare against neighbours. Every figure links back to its .gov.uk source.

Built for UK residents who pay council tax and want to know what happens to their money.

Highlights

  • 317 council dashboards — budget breakdown, tax bands, CEO salary, suppliers, financial health
  • Head-to-head compare — any two councils, side by side
  • National insights — rankings, league tables, postcode lottery data
  • 4 plain-English guides — how council tax works, how spending is structured, who runs your council, how to influence decisions
  • Town Hall — residents propose and vote on how their council should spend money
  • Developer API — free JSON per-council endpoints + embeddable iframe widgets, no key, 100 req/min
  • Data provenance — per-field source URLs for every council (317 pages)
  • WCAG 2.1 AA accessible, designed for 44px tap targets + plain English

Tech stack

Next.js 16 (App Router, Turbopack) · React 19 · TypeScript 5 · Tailwind CSS 4 · shadcn/ui · Supabase (auth + Town Hall) · Vercel

Architecture

The compiled dataset lives in a private repository that's fetched at build time using a token. This public repo contains the application code, a small fixture of 3 councils for local development, and automation scripts.

civaccount/                      # ← this repo (public, MIT code)
├── src/
│   ├── app/                     # Next.js App Router
│   ├── components/              # UI + dashboard cards
│   ├── data/
│   │   ├── councils-fixtures/   # 3-council fixture for local dev
│   │   └── councils/            # Private submodule (.gitignored)
│   └── lib/
├── scripts/                     # Build + validation scripts
└── public/                      # Static assets, llms.txt, robots.txt

Running locally

git clone https://github.com/wulfsagedev/civaccount.git
cd civaccount
npm install
npm run dev

By default you'll see the site running against the 3-council fixture (Kent, Birmingham, Westminster). All pages work; non-fixture councils show 404 in dev.

Open http://localhost:3000.

Data sources

Everything comes from UK government sources — no third-party aggregators:

Full methodology: civaccount.co.uk/methodology

API

Free, public, no key required.

GET /api/v1/councils/[slug]        # Full record for one council
GET /api/v1/councils?search=kent   # Filtered search (slim records, max 20)
GET /api/v1/diffs?since=2026-04-01 # Data-change feed

Full docs + embed snippets: civaccount.co.uk/developers

Licence

Dual licence:

  • CodeMIT. Use, modify, distribute.
  • Compiled datasetCivAccount Data Licence. View and cite individual figures with attribution. No bulk copying, redistribution, or competing products.

The underlying raw government data is Crown Copyright under the Open Government Licence v3.0 and freely available from GOV.UK.

Contributing

Bug reports and fixes to the application code are welcome — open an issue or pull request. For the data layer (adding councils, refreshing figures, enrichment), see CONTRIBUTING.md.

Not affiliated

CivAccount is an independent civic-tech project. Not affiliated with any UK council, government body, political party, or commercial data aggregator.


About

Free, independent transparency tool for UK council budgets. See where your council tax goes across all 317 English councils — tax bands, spending breakdowns, CEO salaries, suppliers, comparisons. 100% from .gov.uk sources.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors