Resilience Hub Toolkit

When disasters hit, internet access goes first. Communities that prepared offline — who know their neighbors, have their supplies, have walked through the plans — do better. This toolkit gives community members a way to work through disaster preparedness together, on-device, without needing an internet connection after the first visit. All data stays on the device via IndexedDB. No accounts, no cloud sync, no server.

Live site: https://resiliencetoolkit.org Hosting: Cloudflare Pages (auto-deploys on push to main)

---

How to run locally

# From resiliencetoolkit.org/
pnpm install
pnpm dev          # Dev server at localhost:4321
pnpm build        # astro check && astro build (postbuild generates SW precache)
pnpm preview      # Preview the build output
pnpm vitest run   # Unit tests
npx playwright test  # E2E tests (requires dev server running in another terminal)

---

Project structure

src/
  pages/                    # File-based routing — all routes are hardcoded .astro files
    index.astro             # Homepage
    dashboard.astro         # Progress tracking dashboard
    modules/
      emergency-preparedness/
        index.astro         # Module overview
        1-1.astro           # Section pages (1-1 through 1-13, hardcoded)
        ...
      baseline-resilience/
        index.astro
        2-1.astro through 2-3.astro
      knowing-your-community.astro
  content/
    modules/                # YAML metadata — section order, titles, slugs, phases
  components/               # Astro + React UI components
  design-system/blocks/     # Interactive blocks: Todo, EditableTable, InteractiveChecklist
  layouts/
    BaseLayout.astro        # Global layout
    ModuleLayout.astro      # Module page layout (TOC sidebar + prev/next nav)
  lib/
    storage.ts              # IndexedDB wrapper (singleton)
    navigation.ts           # Computes prev/next links from YAML metadata
  data/
    modules.ts              # Module list, phase filtering
  styles/base.css           # CSS variables (oklch color space, dark mode tokens)

public/
  sw.js                     # Service worker source template (sentinels replaced at build time)
  manifest.json             # PWA manifest

scripts/
  generate-sw-precache.mjs  # Postbuild: generates PRECACHE_ASSETS in dist/sw.js from dist/ routes

tests/e2e/                  # Playwright tests

Source of truth: The Resilience Hub Toolkit PDF is the authoritative content. The site is a digital interface to that content — local-first interactive checklists that mirror the workbook. When content decisions conflict, the PDF wins.

---

Tech stack

• Astro 5 — static output, no server rendering
• React 18 — interactive islands only (checkboxes, tables, dashboard)
• Tailwind CSS 3 — utility classes + CSS variable design tokens
• IndexedDB via idb — all user data stored locally, nothing leaves the device
• TypeScript — strict mode
• pnpm — package manager
• Vitest — unit tests (storage layer + data preservation)
• Playwright — E2E tests

---

See CONTRIBUTING.md for how to fork, add sections, and contribute back.