Varnasr · Jul 9, 2026 · Jul 8, 2026
@@ -7,7 +7,22 @@ on:
     branches: [main]
 
 jobs:
+  validate-data:
+    name: Validate case-study data
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Validate data & derived artefacts are in sync
+        run: npm run validate
+
   check-links:
+    name: Check links
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -17,4 +32,3 @@ jobs:
         with:
           args: --accept 200,204,301,302,403,429 --exclude-mail --exclude "localhost|127.0.0.1|example.com|twitter.com|x.com|linkedin.com|facebook.com|instagram.com|t.me|wa.me|play.google.com|apps.apple.com" --timeout 30 --max-retries 2 "**/*.html" "**/*.md"
           fail: false
-
@@ -1,6 +1,4 @@
 node_modules/
-package-lock.json
-package.json
 
 # Added by git standards propagation
 # Environment files

@@ -3,7 +3,7 @@ message: "If you use this resource, please cite it as below."
 type: dataset
 title: "Dev Case Studies"
 abstract: >-
-  A collection of 200 real development case studies from 117 countries,
+  A collection of 204 real development case studies from 117 countries,
   searchable and filterable, with full citations. Part of the ImpactMojo
   Learning Platform.
 authors:

@@ -3,101 +3,104 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Varnasr/dev-case-studies/pulls)
 [![GitHub Issues](https://img.shields.io/github/issues/Varnasr/dev-case-studies)](https://github.com/Varnasr/dev-case-studies/issues)
-[![GitHub Last Commit](https://img.shields.io/github/last-commit/Varnasr/dev-case-studies)](https://github.com/Varnasr/dev-case-studies/commits/main)
+[![CI](https://github.com/Varnasr/dev-case-studies/actions/workflows/ci.yml/badge.svg)](https://github.com/Varnasr/dev-case-studies/actions/workflows/ci.yml)
 [![Part of ImpactMojo](https://img.shields.io/badge/Part%20of-ImpactMojo-orange)](https://www.impactmojo.in)
 
-**200 real development case studies from 117 countries — searchable, filterable, and fully cited.**
+**204 real development case studies from 117 countries — searchable, filterable, and fully cited.**
 
 Part of the [ImpactMojo Learning Platform](https://impactmojo.in) and the [OpenStacks for Change](https://github.com/Varnasr/OpenStacks-for-Change) initiative.
 
 ---
 
 ## About
 
-Dev Case Studies is a practitioner-oriented library of real-world development case studies drawn from across the Global South and beyond. Each case study documents a programme, intervention, or policy with evidence of outcomes — positive, negative, or mixed.
+Dev Case Studies is a practitioner-oriented library of real-world development case studies drawn from across the Global South and beyond. Each case documents a programme, intervention, or policy with evidence of outcomes — positive, negative, or mixed — and ties every claim back to a citable source.
 
-The library is designed to complement theory with evidence: to help practitioners, students, and researchers understand what development work actually looks like in practice.
+The library is designed to complement theory with evidence: to help practitioners, students, and researchers understand what development work actually looks like in practice. Read more on the [About & Methodology](about.html) page.
 
 ---
 
 ## Features
 
 | Feature | Description |
 |---------|-------------|
-| **200 Case Studies** | Spanning 117 countries across the Global South and beyond |
-| **Searchable** | Full-text search by keyword, country, programme name, or theme |
-| **Filterable** | Narrow by region, sector, development outcome, and evidence type |
-| **Fully Cited** | Every case includes verifiable sources, evaluation reports, and primary references |
-| **Individual Case Pages** | Dedicated `study.html` views with full detail and citation links |
-| **Zero Dependencies** | Vanilla HTML, CSS, and JavaScript — no build step, no framework |
+| **204 case studies** | Spanning 117 countries across the Global South and beyond, with ~870 cited references. |
+| **Search & filter** | Full-text search plus faceted filters by topic, region, and decade — with an experimental research-question matcher. |
+| **Insights dashboard** | Live statistics on how the collection is distributed across topics, regions, and decades. Click a bar to filter. |
+| **Evidence tiers** | Every study is auto-tagged *strong / moderate / emerging* based on reference count and causal-identification methods. |
+| **Saved studies** | Bookmark cases to a personal reading list stored in your browser — no account required. |
+| **Reading experience** | Reading-time estimates, a scroll progress bar, share links, and per-study Cornell notes you can export as Markdown. |
+| **Related studies map** | A small literature map surfaces cases connected by shared topic or region. |
+| **Light / dark / system theme** | Persisted theme with a three-way toggle. |
+| **Fast & durable** | Zero runtime dependencies — static HTML, CSS, and vanilla JS. |
 
 ---
 
-## Sectors Covered
+## Tech Stack
 
-| Sector | Example Cases |
-|--------|--------------|
-| **Health & Nutrition** | BRAC Community Health Workers (Bangladesh), Progresa/Oportunidades (Mexico) |
-| **Education** | Pratham's Teaching at the Right Level (India), Girls' education programmes (Niger) |
-| **Gender & Women's Empowerment** | Self-help group models (India), Gender-responsive budgeting (Rwanda) |
-| **Livelihoods & Labour** | Graduation programmes, youth employment schemes |
-| **Agriculture** | Smallholder extension, climate-smart agriculture |
-| **Social Protection** | Cash transfer programmes, universal basic income pilots |
-| **Governance** | Community monitoring, social accountability mechanisms |
-| **Climate & Environment** | Adaptation programmes, REDD+, urban resilience |
-| **Digital Development** | Last-mile connectivity, digital financial services |
+| Layer | Technology | Purpose |
+|-------|-----------|---------|
+| Frontend | Vanilla HTML / CSS / JavaScript | No-framework, no-runtime-dependency search and browse |
+| Data | Per-study JSON (source of truth) | Case study content and metadata |
+| Build | Zero-dependency Node (ESM) pipeline | Validates data and generates the card index, search index, stats, and sitemap |
+| CI | GitHub Actions | Validates the schema, fails on data drift, and checks links |
+| Hosting | GitHub Pages | Static site deployment |
 
 ---
 
 ## Project Structure
 
 ```
 dev-case-studies/
-├── index.html          # Main library (search + filter interface)
-├── study.html          # Individual case study view
-├── data/               # Case study data files (JSON/CSV)
-├── css/                # Stylesheets
-├── js/                 # Search, filter, and render logic
-├── CITATION.cff        # Citation metadata
-├── LICENSE             # MIT License
-└── README.md           # This file
+├── index.html            # Library: search, filter, insights dashboard
+├── study.html            # Individual case study view
+├── about.html            # About & methodology
+├── css/style.css         # Design system (light/dark)
+├── js/app.js             # Search, filter, render, bookmarks, insights
+├── scripts/
+│   ├── build.mjs         # Validate studies + generate derived data
+│   └── serve.mjs         # Zero-dependency local dev server
+├── data/
+│   ├── studies/          # ← source of truth: one JSON per case study
+│   ├── master-list.json  # generated — card index (do not edit)
+│   ├── search-index.json # generated — search index (do not edit)
+│   ├── stats.json        # generated — dashboard statistics (do not edit)
+│   └── README.md         # data model & pipeline docs
+├── sitemap.xml           # generated
+└── package.json          # npm scripts (build / validate / dev)
 ```
 
 ---
 
-## Tech Stack
-
-| Layer | Technology | Purpose |
-|-------|-----------|---------|
-| Frontend | Vanilla HTML / CSS / JavaScript | No-dependency search and browse |
-| Data | JSON / CSV | Case study content and metadata |
-| Hosting | GitHub Pages | Static site deployment |
-
----
-
 ## Local Development
 
 ```bash
 git clone https://github.com/Varnasr/dev-case-studies.git
 cd dev-case-studies
-open index.html
-# or
-python3 -m http.server 8000
+
+npm run dev        # serve locally on http://localhost:8000
+npm run build      # regenerate master-list, search index, stats, sitemap
+npm run validate   # CI check: validate the data & fail if artefacts drift
 ```
 
+No dependencies are installed — the build and dev server use only the Node standard library (Node ≥ 18).
+
+The data model and the recognised study-content headings are documented in [`data/README.md`](data/README.md).
+
 ---
 
 ## Contributing
 
 Contributions are welcome — additional case studies, corrections, or improved citations.
 
-See the [issues tracker](https://github.com/Varnasr/dev-case-studies/issues) for open requests, or open a pull request directly.
+**To add a case study:**
 
-**For each new case study, please provide:**
-- Programme name, country, and years of operation
-- Programme description (200–400 words)
-- Evidence of outcomes (with citations)
-- At least two verifiable sources
+1. Create `data/studies/<slug>.json` following the [data model](data/README.md). Include:
+   - programme name, country, region, topic, and years of operation
+   - a 200–400 word description with cited evidence of outcomes
+   - at least two verifiable sources in a `## References` section
+2. Run `npm run build` and commit the regenerated data files.
+3. Open a pull request. CI (`npm run validate`) will fail if the generated data is out of sync.
 
 ---
 
@@ -119,6 +122,6 @@ MIT License — see [LICENSE](LICENSE) for details.
 ## Citation
 
 ```
-Sri Raman, V. (2025). Dev Case Studies: 200 real development case studies from 117 countries [Dataset].
+Sri Raman, V. (2025). Dev Case Studies: 204 real development case studies from 117 countries [Dataset].
 ImpactMojo. https://github.com/Varnasr/dev-case-studies
 ```