🚀 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

Visual Elements Catalog

A reference catalog showing one slide per element type and geometric primitives supported by EduVis

Pattern: direct_instruction    Slides: 13    Phases: explain × 13 (one per element type variant)

Serves as an exhaustive visual playground for all mathematical and general visual components. Includes advanced 3D shapes (cylinders, cones, prisms), 2D coordinate planes with equations, bar models, fraction circles, and specialized math grids for step-by-step arithmetic.

All 13 rendered slides:

Bar Model
bar_model comparison
Solid Pyramid
solid_shape pyramid
Solid Cone
solid_shape cone
Solid Cylinder
solid_shape cylinder
Solid Cube
solid_shape cube
Solid Prism
solid_shape rectangular prism
Coordinate Plane
coordinate_plane line
Fraction Model
fraction_model circle
Factor Array
factor_array dots
Hint List
hint_list standalone
Math Grid Arithmetic
math_grid addition
Math Grid Ratio
math_grid ratio table
Geometry Shape
geometry_shape triangle
View YAML Spec

Assessment Schemas & Mastery

Leveraging assessment target annotations, marking schemes, and misconception mappings for tracking mastery

Pattern: direct_instruction    Slides: 4    Phases: explain → practice × 3

Highlights the rich metadata layer that powers assessment logic, automated marking (e.g. algebraic syntax equivalence), misconception diagnostics, and method-and-accuracy grading rubrics. These annotations drive the telemetry events that feed the Learner State and Mastery Projection models.

All 4 rendered slides:

Overview
explain — overview
MCQ check
check — linear equation MCQ
Short Answer 1
check — expand and simplify
Short Answer 2
check — factorise expression
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