WilliamsJason/pnwmoths

Static rebuild of pnwmoths.biol.wwu.edu using Eleventy, DuckDB/Parquet, Vite, and Lit web components

★ 0Forks 0JavaScriptGitHub ↗Compare

README

PNW Moths

A static rebuild of pnwmoths.biol.wwu.edu — a natural history catalog of Pacific Northwest moths.

The site is generated entirely at build time from flat files (CSV + Markdown). There is no server or database at runtime. Each species page includes taxonomy, prose description, photos, occurrence map, phenology chart, and similar species links.

How it works

Data lives in data/:

  • species.csv — taxonomy, common names, NOC IDs
  • records.csv — ~100k occurrence records (lat/long, date, collector, record type)
  • glossary.csv — illustrated glossary terms

At build time, a DuckDB script joins the CSVs, validates integrity, and exports a per-species Parquet file alongside each HTML page. The browser loads occurrence data asynchronously from those Parquet files — nothing is embedded inline.

The site is built with Eleventy (HTML generation), Vite (JS bundling), and Lit web components for the interactive factsheet features (map, chart, filters, slideshow). Search is powered by Pagefind, which indexes the site at build time.

Deployment

A push to main triggers GitHub Actions: build → index → validate → deploy to GitHub Pages. The full build runs in Docker for local reproducibility. See CONTRIBUTING.md for setup instructions.

Adding content

Plain-English instructions for common maintenance tasks are in _instructions/:

License

Data and content © respective contributors. Code MIT.

Contributors

rainheaddependabot[bot]WilliamsJasonCopilot

Issues