# gonzo-engineering/teeline-online architecture

> Architecture diagram of the GitHub repository gonzo-engineering/teeline-online, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gonzo-engineering/teeline-online
- Repository: https://github.com/gonzo-engineering/teeline-online

## Overview

teeline.online is a SvelteKit study site for learning Teeline shorthand. Learners browse lessons and outline references, view animated shorthand forms, and use generator/revision tools to practice words and passages. Its core model is outline objects containing meanings and SVG line geometry; rendering turns those paths into labeled, optionally animated diagrams. The README documents 240+ outlines and generated combinations, while the tree shows additional lesson, search, disemvoweling, and practice features. Some feature modules were not excerpted, so their internal calls are omitted rather than inferred.

Main entry points: [`website/src/lib/components/outlineSVGs/OutlineSVG.svelte`](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/outlineSVGs/OutlineSVG.svelte) (Outline diagram), [`website/src/lib/components/PageTeaserCard.svelte`](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/PageTeaserCard.svelte) (Page teaser), [`website/src/lib/data/interfaces/interfaces.ts`](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/interfaces/interfaces.ts) (Outline objects), [`website/src/lib/components/ShorthandPassage.svelte`](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/ShorthandPassage.svelte) (Passage renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning content"]
  node_home["Home and teasers<br/>[+page.svelte]"]
  node_lesson_index["Lesson index<br/>[+page.svelte]"]
  node_lesson_content["Lesson pages<br/>[+page.svelte]"]
  node_lesson_loader["Lesson loader<br/>[+page.ts]"]
  node_syllabus["Syllabus metadata<br/>[syllabus.ts]"]
  node_about["About page<br/>[+page.svelte]"]
  node_teaser_card["Page teaser"]
  node_header["Site navigation<br/>[Header.svelte]"]
  node_header_link["Navigation link<br/>[HeaderLink.svelte]"]
end

subgraph group_outlines["Outline reference"]
  node_outline_catalog["Outline catalog<br/>[+page.svelte]"]
  node_outline_api["Outline API<br/>[+server.ts]"]
end

subgraph group_practice["Practice tools"]
  node_generator["Word generator<br/>[+page.svelte]"]
  node_revision["Revision practice<br/>[+page.svelte]"]
  node_search["Outline search<br/>[search.ts]"]
  node_word_disemvowel["Word disemvoweler"]
  node_passage_disemvowel["Passage disemvoweler"]
  node_disemvowel_logic["Disemvowel logic<br/>[disemvowel.ts]"]
  node_outline_builder["Outline builder"]
end

subgraph group_rendering["Outline rendering"]
  node_outline_svg["Outline diagram<br/>[OutlineSVG.svelte]"]
  node_line_renderer["Animated lines<br/>[Lines.svelte]"]
  node_outline_cards["Outline cards"]
  node_outline_details["Outline details"]
  node_passage_renderer["Passage renderer"]
end

subgraph group_shared["Shared data and state"]
  node_outline_data["Outline objects<br/>[interfaces.ts]"]
  node_user_state["User preferences"]
  node_letter_hierarchy["Letter hierarchy"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_home
node_learner -->|"browses"| node_lesson_index
node_learner -->|"consults"| node_outline_catalog
node_learner -->|"practices with"| node_generator
node_learner -->|"practices with"| node_revision
node_lesson_index -.->|"uses metadata"| node_syllabus
node_lesson_content -.->|"loads through"| node_lesson_loader
node_home -.->|"shows teasers"| node_teaser_card
node_teaser_card -->|"renders example"| node_outline_cards
node_teaser_card -->|"renders outline"| node_outline_svg
node_teaser_card -->|"filters meanings"| node_outline_data
node_outline_api -.->|"serves outlines"| node_outline_data
node_outline_catalog -.->|"displays outlines"| node_outline_data
node_generator -.->|"builds outlines"| node_outline_builder
node_revision -.->|"searches outlines"| node_search
node_word_disemvowel -.->|"uses"| node_disemvowel_logic
node_passage_disemvowel -.->|"uses"| node_disemvowel_logic
node_passage_renderer -->|"renders outlines"| node_outline_svg
node_passage_renderer -->|"renders details"| node_outline_details
node_outline_svg -->|"renders lines"| node_line_renderer
node_outline_svg -->|"accepts outline"| node_outline_data
node_outline_svg -->|"reads drawing speed"| node_user_state
node_outline_cards -->|"uses details"| node_outline_details
node_header -->|"renders links"| node_header_link

click node_home "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/%2Bpage.svelte"
click node_lesson_index "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%2Bpage.svelte"
click node_lesson_content "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%5Bslug%5D/%2Bpage.svelte"
click node_lesson_loader "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%5Bslug%5D/%2Bpage.ts"
click node_syllabus "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/syllabus.ts"
click node_about "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/about/%2Bpage.svelte"
click node_outline_catalog "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/outlines/%2Bpage.svelte"
click node_outline_api "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/api/outlines/%2Bserver.ts"
click node_outline_data "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/interfaces/interfaces.ts"
click node_generator "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/generator/%2Bpage.svelte"
click node_revision "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/revise/%2Bpage.svelte"
click node_search "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/search.ts"
click node_word_disemvowel "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/disemvoweler/WordDisemvoweler.svelte"
click node_passage_disemvowel "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/disemvoweler/PassageDisemvoweler.svelte"
click node_disemvowel_logic "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/disemvowel.ts"
click node_outline_builder "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/outline-building/build-outline-objects.ts"
click node_outline_svg "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/outlineSVGs/OutlineSVG.svelte"
click node_line_renderer "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/outlineSVGs/Lines.svelte"
click node_outline_cards "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/cards/OutlineCardFlipping.svelte"
click node_outline_details "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/cards/OutlineDetails.svelte"
click node_passage_renderer "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/ShorthandPassage.svelte"
click node_teaser_card "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/PageTeaserCard.svelte"
click node_user_state "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/global-state/global-state.svelte.ts"
click node_letter_hierarchy "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/letter-hierarchy.ts"
click node_header "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/layout/Header.svelte"
click node_header_link "https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/layout/HeaderLink.svelte"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_lesson_index,node_lesson_content,node_lesson_loader,node_syllabus,node_about,node_teaser_card,node_header,node_header_link toneBlue
class node_outline_catalog,node_outline_api toneAmber
class node_generator,node_revision,node_search,node_word_disemvowel,node_passage_disemvowel,node_disemvowel_logic,node_outline_builder toneMint
class node_outline_svg,node_line_renderer,node_outline_cards,node_outline_details,node_passage_renderer toneRose
class node_outline_data,node_user_state,node_letter_hierarchy,node_learner toneIndigo
```

## Components

### Learning content

- [Home and teasers](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/%2Bpage.svelte): `website/src/routes/+page.svelte`
- [Lesson index](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%2Bpage.svelte): `website/src/routes/learn/+page.svelte`
- [Lesson pages](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%5Bslug%5D/%2Bpage.svelte): `website/src/routes/learn/[slug]/+page.svelte`
- [Lesson loader](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/learn/%5Bslug%5D/%2Bpage.ts): `website/src/routes/learn/[slug]/+page.ts`
- [Syllabus metadata](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/syllabus.ts): `website/src/lib/data/syllabus.ts`
- [About page](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/about/%2Bpage.svelte): `website/src/routes/about/+page.svelte`
- [Page teaser](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/PageTeaserCard.svelte): `website/src/lib/components/PageTeaserCard.svelte`
- [Site navigation](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/layout/Header.svelte): `website/src/lib/components/layout/Header.svelte`
- [Navigation link](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/layout/HeaderLink.svelte): `website/src/lib/components/layout/HeaderLink.svelte`

### Outline reference

- [Outline catalog](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/outlines/%2Bpage.svelte): `website/src/routes/outlines/+page.svelte`
- [Outline API](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/api/outlines/%2Bserver.ts): `website/src/routes/api/outlines/+server.ts`

### Practice tools

- [Word generator](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/generator/%2Bpage.svelte): `website/src/routes/generator/+page.svelte`
- [Revision practice](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/routes/revise/%2Bpage.svelte): `website/src/routes/revise/+page.svelte`
- [Outline search](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/search.ts): `website/src/lib/scripts/search.ts`
- [Word disemvoweler](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/disemvoweler/WordDisemvoweler.svelte): `website/src/lib/components/disemvoweler/WordDisemvoweler.svelte`
- [Passage disemvoweler](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/disemvoweler/PassageDisemvoweler.svelte): `website/src/lib/components/disemvoweler/PassageDisemvoweler.svelte`
- [Disemvowel logic](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/disemvowel.ts): `website/src/lib/scripts/disemvowel.ts`
- [Outline builder](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/scripts/outline-building/build-outline-objects.ts): `website/src/lib/scripts/outline-building/build-outline-objects.ts`

### Outline rendering

- [Outline diagram](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/outlineSVGs/OutlineSVG.svelte): `website/src/lib/components/outlineSVGs/OutlineSVG.svelte`
- [Animated lines](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/outlineSVGs/Lines.svelte): `website/src/lib/components/outlineSVGs/Lines.svelte`
- [Outline cards](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/cards/OutlineCardFlipping.svelte): `website/src/lib/components/cards/OutlineCardFlipping.svelte`
- [Outline details](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/cards/OutlineDetails.svelte): `website/src/lib/components/cards/OutlineDetails.svelte`
- [Passage renderer](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/components/ShorthandPassage.svelte): `website/src/lib/components/ShorthandPassage.svelte`

### Shared data and state

- [Outline objects](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/interfaces/interfaces.ts): `website/src/lib/data/interfaces/interfaces.ts`
- [User preferences](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/global-state/global-state.svelte.ts): `website/src/lib/global-state/global-state.svelte.ts`
- [Letter hierarchy](https://github.com/gonzo-engineering/teeline-online/blob/main/website/src/lib/data/letter-hierarchy.ts): `website/src/lib/data/letter-hierarchy.ts`

### Other components

- **Learner**

## Connections

- Learner → Home and teasers: opens
- Learner → Lesson index: browses
- Learner → Outline catalog: consults
- Learner → Word generator: practices with
- Learner → Revision practice: practices with
- Lesson index → Syllabus metadata: uses metadata
- Lesson pages → Lesson loader: loads through
- Home and teasers → Page teaser: shows teasers
- Page teaser → Outline cards: renders example (evidence: `website/src/lib/components/PageTeaserCard.svelte`)
- Page teaser → Outline diagram: renders outline (evidence: `website/src/lib/components/PageTeaserCard.svelte`)
- Page teaser → Outline objects: filters meanings (evidence: `website/src/lib/components/PageTeaserCard.svelte`)
- Outline API → Outline objects: serves outlines
- Outline catalog → Outline objects: displays outlines
- Word generator → Outline builder: builds outlines
- Revision practice → Outline search: searches outlines
- Word disemvoweler → Disemvowel logic: uses
- Passage disemvoweler → Disemvowel logic: uses
- Passage renderer → Outline diagram: renders outlines (evidence: `website/src/lib/components/ShorthandPassage.svelte`)
- Passage renderer → Outline details: renders details (evidence: `website/src/lib/components/ShorthandPassage.svelte`)
- Outline diagram → Animated lines: renders lines (evidence: `website/src/lib/components/outlineSVGs/OutlineSVG.svelte`)
- Outline diagram → Outline objects: accepts outline (evidence: `website/src/lib/components/outlineSVGs/OutlineSVG.svelte`)
- Outline diagram → User preferences: reads drawing speed (evidence: `website/src/lib/components/outlineSVGs/OutlineSVG.svelte`)
- Outline cards → Outline details: uses details (evidence: `website/src/lib/components/cards/OutlineCardFlipping.svelte`)
- Site navigation → Navigation link: renders links (evidence: `website/src/lib/components/layout/Header.svelte`)
