Update README and CITATION for current state of the project

- Add 4 new sections (Performing Arts, Climate, Justice, Digital/Media)
- Document Sankey and chord diagrams in new Visualisations section
- Update tool count to 18, add Briefing and Compare tools
- Add D3.js to tech stack
- Note full bilingual status (17/17 sections)
- Document Ctrl+K shortcuts and responsive design
- Update CITATION keywords and release date

https://claude.ai/code/session_01S5VX8Ra3YuCGc9Zp6B64oe

Author: claude

CITATION.cff

@@ -16,8 +16,13 @@ keywords:
   - caste
   - development
   - data-visualization
+  - d3
+  - sankey
+  - chord-diagram
   - geography
   - culture
+  - migration
+  - bilingual
   - listening-circles
 
-date-released: "2025-03-30"
+date-released: "2026-03-31"

README.md

@@ -19,58 +19,75 @@ This is not a textbook or a tourism site. It is a working resource built for peo
 | **Geography** | North-South divide, flood politics, Nepal water nexus, Diara lands |
 | **Society** | Caste structure, land ownership, electoral sociology, gender indicators |
 | **Economy** | Jobless growth, agrarian crisis, remittance dependency, 8-10M migrant workers |
-| **Issues** | Naxal history, prohibition, health/education failure, water/sanitation, climate |
+| **Issues** | Naxal history, prohibition, health/education failure, water/sanitation |
 | **People** | Ashoka to Karpoori Thakur, Bhikhari Thakur to Phanishwarnath Renu |
-| **Food** | Litti chokha to makhana economics, caste on the plate |
+| **Food** | Litti chokha to makhana economics, caste on the plate, regional cuisines |
 | **Culture** | Madhubani painting, Bidesia theatre, Chhath Puja, linguistic politics |
+| **Performing Arts** | Bidesia, Jat-Jatin, Domkach, Sama-Chakeva, puppetry traditions |
 | **Crafts** | 6 craft traditions with economics (maker price vs retail price) |
+| **Climate** | Flood-drought cycle, Kosi embankment politics, heat stress, groundwater depletion |
+| **Justice** | Naxal legacy, caste violence, prohibition enforcement, undertrial crisis |
+| **Digital & Media** | WhatsApp politics, Bhojpuri YouTube, gender digital divide, DBT barriers |
 | **Stories** | 45 perspective pieces -- makhana divers, child brides, ASHA workers, hooch deaths |
-| **Data** | District indicator map, 12+ charts, Bihar vs India comparisons |
-| **Tools** | 16 interactive tools (see below) |
-| **Briefing** | Select a district, see everything on one page |
-| **Compare** | Bihar vs 9 states on 9 indicators |
+| **Data** | District indicator map, 12+ charts, Sankey & chord diagrams, Bihar vs India comparisons |
+| **Tools** | 18 interactive tools (see below) |
 
-## Tools (16)
+## Tools (18)
 
-- Surname Lookup -- caste category database
-- Bihar Lexicon -- 16 searchable terms with etymology
+- Surname Lookup -- caste category database (60+ entries)
+- Bihar Lexicon -- searchable terms with etymology (Maithili, Bhojpuri, Magahi)
 - District Data Explorer -- Census data for 20 districts
-- Flood Risk Checker -- risk level and river systems
+- Flood Risk Checker -- risk level and river systems (BSDMA data)
 - Development Comparator -- multi-district chart generator
 - Constituency Lookup -- 15 Lok Sabha seats, 2024 results, margins, caste profiles
 - Issue Priority Ranker -- ranked local issues by district
 - Scheme Gap Finder -- MGNREGA, PM-Kisan, Ujjwala coverage vs national average
-- District Indicator Map -- color-coded Bihar map by literacy, sex ratio, urbanisation, density
+- Reading List Generator -- 24 open-access sources, 8 topic filters
 - Impact Calculator -- translates statistics into human terms
 - Bihar Timeline -- 28 events from 600 BCE to 2024
 - Voices of Bihar -- 20 published quotes, filterable by theme
 - District One-Pager -- printable summary for fieldworkers
 - Facilitator Guide -- 6 audience-specific listening circle session plans
 - WhatsApp Fact Cards -- 12 pre-formatted Hindi messages, one-tap share
-- Reading List Generator -- 24 open-access sources, 8 topic filters
+- District Briefing -- everything about one district on one page
+- Bihar vs States -- compare Bihar against 9 states on 9 indicators
+- District Indicator Map -- color-coded Bihar map by literacy, sex ratio, urbanisation, density
+
+## Visualisations
+
+- **12+ Chart.js charts** -- bar, line, doughnut, grouped comparisons
+- **Migration flow Sankey** -- source districts → destination states → employment sectors (D3.js)
+- **Budget pipeline Sankey** -- central allocation → scheme delivery with leakage at every stage (D3.js)
+- **Caste-politics chord diagram** -- voting alignment between 7 caste groups and 5 political alliances (D3.js)
+- **District indicator map** -- colour-coded Leaflet map (literacy, sex ratio, urbanisation, density)
+- **Heritage sites map** -- 10 UNESCO/cultural sites with interactive markers
+- **CSS flow diagrams** -- migration routes, cycle of deprivation, revenue flows, scheme delivery chain
 
 ## Features
 
-- **Hindi toggle** -- EN/HI switch for bilingual content
+- **Fully bilingual** -- all 17 sections translated EN/HI (Noto Serif Devanagari)
 - **WhatsApp sharing** -- floating button + per-story share
 - **Search** -- site-wide search across all content
-- **Ctrl+K navigation** -- keyboard shortcut for quick section access
+- **Ctrl+K navigation** -- keyboard shortcuts for quick section access (1-9, S, D, T, R)
 - **Light/Dark/Auto theme** -- 3-mode theme selector
 - **Offline access** -- service worker caches the full site
-- **PNG download** -- download any chart with source watermark
+- **PNG download** -- download any chart or D3 diagram with source watermark
 - **Print** -- printable district briefings and one-pagers
 - **Password protected** -- client-side access gate
+- **Responsive** -- mobile-first CSS, works on all screen sizes
 
 ## Technology
 
 Single HTML file. No build system. No framework.
 
-- Chart.js for data visualisation
-- Leaflet.js for interactive maps
-- CSS-only diagrams (no Mermaid dependency)
-- Noto Serif Devanagari for Hindi
+- **Chart.js 3.9.1** -- bar, line, pie, doughnut charts
+- **D3.js 7.8.5 + d3-sankey** -- Sankey and chord diagrams
+- **Leaflet.js 1.9.4** -- interactive maps
+- CSS-only flow diagrams (no Mermaid dependency)
+- Noto Serif Devanagari for Hindi typography
 - Newsreader + DM Sans + JetBrains Mono typography
-- Service worker for offline capability
+- Service worker for full offline capability
+- Hosted on Netlify (static site)
 
 ## Data Sources