Quickstart - alerum68/Theogony GitHub Wiki

type: concept title: Theogony Quickstart & Navigation Guide description: Serving as the primary onboarding and navigation hub for the Theogony wiki, connecting users and developers to core workflows, concepts, and system architecture. tags: [quickstart, navigation, task-routing, overview, openwiki] sources:

  • id: openwiki-source-651d1fb6c9e49916a916ab51 resource: repo://Cargo.toml
  • id: openwiki-source-0a92e91524b9981ef0c9df55 resource: repo://theogony-app/Cargo.toml
  • id: openwiki-source-61c917696a7dbf739bd28821 resource: repo://theogony-domain/src/lib.rs generated: { by: "openwiki/0.5.1", at: "2026-09-25T18:48:04.838Z" }

Theogony Quickstart & Navigation Guide

Welcome to the Theogony OpenWiki! This quickstart serves as the central navigation map and task-routing hub for understanding Theogony—a high-performance, local-first genealogy desktop platform engineered for rigorous evidence analysis, multi-user interchange, and historical family tree research.

Whether you are a genealogist exploring user workflows, a researcher studying the Genealogical Proof Standard (GPS), or a developer diving into the Tauri and Rust backend architecture, this guide directs you to the core documentation domains.

Navigation Guide & Task-Routing Map

graph TD
    Root([Theogony Quickstart & Navigation]) --> Arch[System Architecture]
    Root --> Concepts[Core Concepts & Philosophy]
    Root --> Workflows[User Workflows]
    Root --> Operations[Operations & Data Audit]
    Root --> Integrations[Data Portability & GEDCOM]

    Arch -->|Explores| SysOverview[System Overview & Crates]
    Concepts -->|Explores| GPS[Evidence-First Philosophy & GPS]
    Workflows -->|Explores| UserGuides[Interface & Fact Citing]
    Operations -->|Explores| Review[Review Queue & Audit Trail]
    Integrations -->|Explores| Gedcom[GEDCOM 7 & THEB Interchange]

Major Wiki Domains

1. Architecture & System Design

  • System Overview & Architecture: High-level architectural overview of Theogony's local-first genealogy platform, workspace crate layout (theogony-domain, theogony-ports, theogony-db-sqlite, theogony-gedcom, theogony-dna, theogony-ai, theogony-app), Tauri desktop shell, and persistence spine [repo://Cargo.toml, repo://theogony-app/Cargo.toml].

2. Concepts & Methodology

  • Evidence-First Philosophy & GPS Standards: Core philosophical framework and Genealogical Proof Standard (GPS) implementation in Theogony, detailing the four-layer hierarchy separating source documents, extracted personas, asserted claims, and concluded historical individuals and families [repo://theogony-domain/src/lib.rs].

3. User Workflows

  • Core User Workflows: Step-by-step user guidance on navigating the OpenWiki and application interface, recording and citing historical facts, assigning surety ratings, and structuring family relationships.

4. Operations & Data Hygiene

  • Data Hygiene: Review & Audit: Detailed documentation of the Review Queue, unattached persona resolution, edit history, and selective revert mechanisms ensuring absolute data integrity.

5. Integrations & Portability

  • Data Portability & GEDCOM Interchange: Comprehensive guide on data import/export, GEDCOM 5.5.1/7 support, THEB archive packages (.tgpkg), database backups, and lossless data interchange.

Quick Tasks & Common Entrypoints