Content Guide

How to add new lessons with YAML

Content lives in /content/, organized by language and type. Each YAML file describes one lesson you can paste into the importer to add to the app.

Pick a content type below to see its required fields and a copy-paste example.

Open importer Back to content

Folder structure

/content/
  /kirundi/
    /vocabulary/   <-- word lists
    /grammar/      <-- grammar rules
    /conjugation/  <-- verb tables
    /dialogs/      <-- conversations
    /theory/       <-- long-form notes
    /units/        <-- group lessons
  /kinyarwanda/
    ...same structure
  /schemas/        <-- reference schemas

Tags & flashcard bundles

Use category for the primary group and tags for any extra themes. A word can appear in multiple flashcard bundles at once.

- id: ki-apple
  word: Ipera
  translation: Apple
  category: fruits
  tags: [food, healthy]   # appears in 3 bundles

Phonetics are hidden by default. Add pronunciation only if you have an accurate guide; learners can opt-in from Profile.

Content types

Vocabulary

Word lists with translations. Use `tags` to make a word appear in multiple flashcard bundles (e.g. an apple in both 'fruits' and 'food').

Required

idwordtranslation

Optional

pronunciationexampleexampleTranslationcategorytagsnotes

id: my-vocab-lesson
title: Imbuto
titleTranslation: Fruits
description: Common fruit names
difficulty: beginner
estimatedMinutes: 5
language: kirundi
icon: "🍎"

words:
  - id: ki-apple
    word: Ipera
    translation: Apple
    category: fruits
    tags: [food, healthy]

  - id: ki-banana
    word: Igitoki
    translation: Banana
    pronunciation: ee-gee-toh-kee
    example: Ndakunda igitoki.
    exampleTranslation: I love bananas.
    category: fruits
    tags: [food, healthy]

Grammar Rules

Explain grammar concepts with examples and tips. Each rule is shown as a card the learner can swipe through.

Required

idtitleexplanation

Optional

examplestips

id: present-tense-rules
title: Igihe c'ubu
titleTranslation: Present Tense
description: How to form the present tense
difficulty: beginner
estimatedMinutes: 8
language: kirundi
icon: "📝"

rules:
  - id: rule-1
    title: Subject prefix + -ra-
    explanation: |
      The present tense is formed with a subject prefix,
      the marker -ra- (or -da- after n-), and the verb stem.
    examples:
      - original: Ndakora
        translation: I work
      - original: Urakora
        translation: You work
    tips:
      - The -ra- marker indicates ongoing action
      - The final vowel stays as -a in the affirmative

Conjugation

Full conjugation tables for verbs across multiple tenses. Each verb can be conjugated in any number of tenses.

Required

idinfinitivetranslationconjugations

id: gukora-conjugation
title: Gukora
titleTranslation: To Work
description: Conjugating gukora across tenses
difficulty: beginner
estimatedMinutes: 10
language: kirundi
icon: "✏️"

verbs:
  - id: gukora
    infinitive: Gukora
    translation: To work
    conjugations:
      - tense: Present
        forms:
          - pronoun: Jewe
            conjugated: Ndakora
            translation: I work
          - pronoun: Wewe
            conjugated: Urakora
            translation: You work
      - tense: Past
        forms:
          - pronoun: Jewe
            conjugated: Nakoze
            translation: I worked

Dialog

Conversational scenarios between two or more speakers. Useful for learning natural phrases in context.

Required

idtitleexchanges

Optional

descriptioncontextvocabulary

id: market-dialog
title: Ku isoko
titleTranslation: At the Market
description: Buying fruits at a local market
difficulty: beginner
estimatedMinutes: 7
language: kirundi
icon: "🛒"

dialogs:
  - id: market-1
    title: Buying Bananas
    context: A buyer talks to a seller
    exchanges:
      - speaker: Buyer
        text: Muraho! Ibitoki ni angahe?
        translation: Hello! How much are the bananas?
      - speaker: Seller
        text: Ni amafaranga magana atatu.
        translation: They are three hundred francs.
    vocabulary:
      - Muraho
      - Ibitoki
      - angahe

Theory

Long-form explanations split into sections. Best for grammar deep-dives or cultural notes.

Required

titlesections

id: verb-structure-theory
title: Inshinga
titleTranslation: Verb Structure
description: How Kirundi verbs are built
difficulty: intermediate
estimatedMinutes: 12
language: kirundi
icon: "📚"

theory:
  title: Understanding Kirundi Verbs
  sections:
    - heading: The Building Blocks
      content: |
        Kirundi verbs are agglutinative: each part of the
        word adds meaning. The structure is:
        Subject + Tense + Root + Final vowel.
      examples:
        - original: Nd-a-som-a
          translation: I read (Nd=I, a=present, som=read, a=final)
    - heading: Subject Prefixes
      content: Subject prefixes show who performs the action.

Unit

Groups several lessons together under a theme. Lessons are referenced by their `id`.

Required

idtitlelessons

Optional

descriptioniconcolor

id: greetings-unit
title: Indamutso
description: Greetings and introductions
icon: "👋"
color: bg-amber-500

lessons:
  - greetings-vocab
  - greetings-grammar
  - greetings-dialog

Workflow

Pick a content type above and copy the example.
Edit the fields in your favorite editor.
Open the YAML importer.
Paste, parse to validate, then import.
Find your new lesson in the Manage screen.