Documentation
Graspful is the fastest way to create adaptive learning courses. Define a course as YAML, import it via CLI or MCP, and get a live product with a landing page, knowledge graph, spaced repetition, and billing.
bun add -g @graspful/cliGet started Getting Started
Quickstart
Install the CLI, scaffold a course, fill concepts, review, and publish — in under 5 minutes.
How It Works
Conceptual overview of the adaptive learning engine — the 7 core principles, two-YAML workflow, and system architecture.
Glossary
Consistent definitions for every platform concept — from Academy to XP. Essential reference for humans and AI agents.
Building Courses
Course Creation Guide
Step-by-step guide to building a course on Graspful. Content-agnostic — works for any subject.
Course Schema
Full YAML schema reference for courses — sections, concepts, knowledge points, problems, and prerequisite edges.
Brand Schema
YAML schema for white-label brands — theme presets, landing page configuration, SEO, and pricing.
Review Gate
The 10 mechanical quality checks that every course must pass before publishing.
Design Guide
Brand colors, typography, spacing, and component patterns. The visual system behind every Graspful brand.
Tools
Concepts
Knowledge Graph
Prerequisites, encompassing edges, and the knowledge frontier that drives adaptive learning.
Mastery Learning
Bayesian Knowledge Tracing, mastery states, and why students never advance without understanding.
Adaptive Diagnostics
MEPE question selection and evidence propagation — how 20-60 questions map student knowledge.
Spaced Repetition
The FIRe algorithm, implicit repetition via encompassing edges, and exponential memory decay.
Task Selection
Priority-based system that chooses lessons, reviews, or remediation — whatever the student needs most.
Gamification
XP calibrated to ~1 point per minute, streaks, leaderboards, and daily caps.
Learning Staircase
Knowledge points with progressive difficulty — recognition, guided application, independent transfer.
The two-YAML workflow
Every Graspful product is defined by two YAML files. A course YAML defines the learning content. A brand YAML configures the product. Import both, and you have a live business.
Step 1
Course YAML
Sections, concepts, prerequisites, knowledge points, and practice problems.
Step 2
Brand YAML
Landing page, theme preset, pricing, SEO, and custom domain.
Step 3
Import & Launch
One command imports both and publishes a live product with billing and adaptive learning.