Theographic

Theographic is a knowledge graph of the Bible, weaving data about people, places, and periods of time into the tapestry of God's story. This data enables smarter search algorithms, new apps, and exciting research potential. It's an open-source project to share information about the scriptures in our digital world. Learn more at this link.

This repository builds the website that lets people explore the data.

v2. The original Gatsby site depended on a Neo4j API that no longer exists. This is the rebuild: a fully static site whose search engine runs in the browser (in a Web Worker, from prebuilt indexes), built from the JSON in theographic-bible-metadata at a pinned commit. It installs as a PWA, works offline after first use, and wraps into iOS/Android shells with Capacitor. Progress, decisions and the pick-up point for contributors: docs/CHECKPOINTS.md.

Search in one box: references (John 3:16, Gen 1-3, Ps 23:1,4, I Sam 17), people and places with aliases and typo tolerance (Saul, Jerusalm), free text over the KJV ("search the scriptures", shew), mixed queries (Paul Antioch, love in John), and filters (in:nt, person:Simon). Add &debug=1 to see why each result ranked where it did.

Layout

• packages/core — the search engine and data model (pure TypeScript; also a CLI: npx theographic search "Paul Antioch")
• packages/data — build pipeline from the metadata JSON to static bundles and indexes; the generated-definitions pipeline
• apps/web — the Astro site (prerendered pages, Preact islands for search, service worker)
• apps/mobile — Capacitor shells for iOS and Android
• docs/ — roadmap, checkpoints, search design, decisions

Development

Requires Node 22.

npm ci
npm run data      # build data bundles and search indexes from the pinned metadata commit
npm run dev       # http://localhost:8001
npm test
npm run build     # static output in apps/web/dist
npm run data:definitions -- submit --dry-run 30   # generated definitions (CP-08; needs an API key)

Contributing

This project is backed by individuals passionate about applying our best technology to the mission of making disciples. Find out how to contribute your creative or technical skills at this link.

License

Code: GNU General Public License v3.0 (LICENSE). Data: Creative Commons Attribution-ShareAlike 4.0 International, CC BY-SA 4.0 (LICENSE-DATA), except the King James text and Easton's dictionary, which are public domain.