🚀 Open Live Editor

EduVis Schema

An open, curriculum-aware schema for educational content. Separate educational meaning from rendering.

What is EduVis?

The Problem

Most diagram libraries describe visuals. EduVis describes learning experiences.

A number line used to introduce a concept, one used to discover a rule, and one shown during recall are pedagogically different objects. Today's tools treat them identically.

The Solution

EduVis captures the teaching pattern — the same structure that makes great human tutors effective:

  • No skipped steps
  • Visual intuition before abstraction
  • Confidence-building before challenge
  • Retrieval to lock it in long-term memory

The Five Pillars

Elements What content type is this?
Actions What does this ask the student to do?
Relationships How does it connect to others in the lesson?
Placement Where does it live in the lesson and memory?
Progression What is the instructional flow?

Try the Live Schema Editor!

Write and test your own EduVis YAML specifications in real-time. Render SVGs instantly client-side using Python WebAssembly.

Open Live Editor

Interactive Showcase

Full Lesson: Negative Numbers

Understanding values below zero — from concrete scenarios (temperature, money) to abstract rules

Pattern: confidence_ladder    Slides: 14    Phases: hook → explore → explain → guided → starter × 3 → routine × 2 → challenge → recall × 2

Demonstrates the full confidence_ladder pattern end-to-end: concrete hook before the rule is named, misconception identified and addressed before independent practice, difficulty ramped from starter to challenge, closed with retrieval practice for long-term retention.

All 14 rendered slides:

Hook
hook — real world
Explore
explore — temperature scale
Explain concept
explain — conceptual model
Explain rule
explain — rule
Misconception
misconception fix
Guided example
guided practice
Starter 1
starter 1
Starter 2
starter 2
Starter 3
starter 3
Routine 1
routine 1
Routine 2
routine 2
Challenge
challenge
Recall 1
recall 1
Recall 2
recall 2
View YAML Spec

Adaptive Tutoring & Telemetry Event Branching

Encoding intelligent tutoring system (ITS) branching and MCQ misconception tracking without hardcoded logic

Pattern: direct_instruction    Slides: 8    Phases: explain × 2 → practice → explain → practice → explain → practice → explain

Demonstrates how EduVis handles student MCQ answers, maps misconceptions dynamically to specific codes, and uses the remediation_for relationship to present a split-screen remediation_block showing the reviewed question, conceptual anchor, and step-by-step solutions.

All 8 rendered slides:

True/False Check
check — true/false
5-Option Check
check — 5-option MCQ
Prime Remediation Block
explain — prime remediation
Composite Number scale
explain — composite intro
Composite check
check — composite check
Composite Remediation
explain — composite remediation
Prime Factors MCQ
check — prime factors
Prime Factors Remediation
explain — factors remediation
View YAML Spec

Full Lesson: Angle Sum of a Triangle

Calculating unknown angles inside a triangle — featuring custom geometry polygon rendering

Pattern: confidence_ladder    Slides: 11    Phases: hook → explore → explain × 2 → guided → starter × 2 → routine × 2 → challenge → recall

Demonstrates how complex vector shapes like triangles with vertex labels, side labels, and angle measures (using geometry_shape) are seamlessly aligned and laid out inside a pedagogical progression flow.

All 11 rendered slides:

Hook
hook — roof truss
Explore
explore — isosceles
Explain concept
explain — conceptual
Explain rule
explain — rule
Guided practice
guided practice
Starter 1
starter 1
Starter 2
starter 2
Routine 1
routine 1
Routine 2
routine 2
Challenge
challenge
Recall 1
recall
View YAML Spec

What You're Seeing

The YAML specs above are the "instructional meaning."
The SVG slides are just one rendering of that meaning.

The same lesson YAML could be rendered as:

EduVis YAML ↓ SVG (rendered above) | React Component | Flutter Widget | PDF | Animated Video

The educational structure — elements, actions, placement, progression, relationships — remains constant. Only the presentation format changes.

GitHub Repository Full Documentation