explico
Turn lecture notes into a course that explains itself. explico is a course engine built for writing with an AI assistant. A shared set of rules keeps everything the author and the AI write consistent. On the reader's side, every symbol explains itself, figures respond to sliders, and each chapter ends with a quiz. The same lesson can also be presented as slides.
Hover a page to bring it forward in the night theme. Click to open that page in the playground. Tap a label to bring its page forward in the night theme. Tap the page to open it in the playground.
What it is for
A course is written once and read many times, by people who meet its notation for the first time. explico serves both sides:
- For the people who write it, an environment where an AI assistant does most of the drafting and a set of rules keeps the result consistent. Some rules guide the writing; others are checked on every build. The same rules make the AI's work and the author's review faster.
- For the people who read it, an interface that makes a technical topic faster and more convenient to understand. It supports sharing (a link to any passage), engagement (interactive figures), and self-testing (a quiz in every chapter).
A course does not have to start from a blank page. Existing lecture notes, documentation, and instructions are the raw material, and the AI turns them into lessons that follow the rules.
Why authors like it
- Start from what you already have. Hand the assistant your lecture notes, a manual, or a set of instructions. It drafts the lessons and you steer and review, in plain language.
- Consistency is not left to memory. About forty rules cover how symbols are written, how figures are drawn, how lessons are structured, and how sentences are worded. The assistant reads the rules before it writes, and the build checks the ones a script can check. See Authoring rules.
- Mistakes are caught before a reader sees them. A symbol nobody defined, a reference to an equation that no longer exists, or a lesson that depends on one that comes later stops the build. The build names the file and the line, so the assistant fixes it on the next pass.
- Your course, your house style. Switch a rule off, tune it, or add rules of your own in a settings form, without touching the engine.
- Readers see what changed. Every release of the course carries a knowledge version and a changelog, shown to readers in the course itself.
Why readers like it
- Every symbol explains itself. Point at a symbol, in the text or inside an equation, to see what it means and its units. Click it to keep the explanation open while you read on.
- Nothing is out of reach. Equations, tables, and figures are numbered, and a reference to one works across chapters. Pointing at the reference shows a preview, so you rarely lose your place.
- Try it, don't just read it. Interactive figures respond to sliders, and the numbers inside the rendered equation change with them.
- Check what you learned. Every chapter ends with a knowledge check.
- Share the exact spot. Every section, equation, table, and figure has its own link. A classmate who opens it lands on that spot, highlighted.
- Read it your way. Light and night themes, a print layout that keeps the page as you left it on screen, and a one-file download of any chapter for reading offline.
Slides from the same lesson
A lecturer can present a lesson, not just publish it. Beside a chapter's text sits its deck, a file of slides written with the same symbols, sources, figures and quiz. A lesson can also be slides only. The assistant drafts the deck from the chapter, and ten slide rules keep every frame short and on one point.
Hover a page to bring it forward in the night theme. Click to open that page in the playground. Tap a label to bring its page forward in the night theme. Tap the page to open it in the playground.
In the lecture room
- Present from the browser. One slide at a time, full screen. The arrow keys and a clicker's buttons step through it, and a number then Enter jumps to that slide.
- A presenter window. It shows the current slide, the next one, the speaker's notes and a clock, and follows the projector.
- Slides that move. A step can reveal the next point, sweep a figure's slider while the room watches, or light up a symbol wherever it appears. A slide can morph from the one before, its shared symbols gliding into place.
- The chapter's results, recalled. A slide shows the chapter's equation, figure or table with the chapter's number, so the slides and the notes never disagree.
- Every symbol still explains itself. A line at the foot of a slide names the symbols it introduces, and pointing at one opens its explanation.
After class
- The same slides as a study page. Every slide in its final state, with the speaker's notes under it, and the figures and quizzes still live.
- Picks up where you stopped. With your permission, the slides offer to continue at the slide you left.
- Offline, in one file. The slides download as a single HTML file that still presents, with notes, figures and quizzes working.
On paper
- A PDF in beamer, the slide format lecturers already know, where every symbol links to its entry in a notation section at the end: slides, and the handout, each slide followed by its notes and the quiz's answers.
- The LaTeX source, to edit in your own template, and the slides in Marp's Markdown, which opens in Marp or its VS Code extension.
- Slide numbers that agree. Slide 7 is slide 7 on the web, in the PDF and in the address bar. The build fails if a slide overflows its frame, or if the PDF numbers a slide differently.
Built on proven tools, not from scratch. The site is Astro with Starlight; lessons are MDX; formulas are rendered by KaTeX when the site is built; figures are React components, charts are drawn with Observable Plot, and diagrams are laid out by Dagre. Presenting uses what browsers already provide: the Fullscreen API, View Transitions for the morphs, and a BroadcastChannel to keep the presenter window in step. The PDF is beamer under LuaLaTeX, with TikZ for diagrams. Playwright drives a headless Chromium at build time to check that every slide fits and to draw the figures as vector PDF. explico's own part is the layer in between: the notation and its checks, the rules, and the slide controller, which is explico's own rather than reveal.js, so that a slide keeps the course's symbol cards, live figures, quizzes and numbers.
Two courses to read
The playground is a feature tour: four short chapters on motion in the plane and projectile motion, each with its slides, and a lesson on Newton's cannonball taught as slides only. Every reader-facing feature of explico appears in it at least once. It is small on purpose, a test bed rather than a physics course. The playground guide lists what is in it.
credit-and-derivatives is a real, working course built on explico, at full scale: discounting and rates, bonds and bond options, credit and CDS, derivatives and options, in seven parts. It shows the engine carrying the notation load of an actual quantitative-finance course.
Learn more
- Authoring rules: how the rules are enforced, tuned in a form, and extended with a course's own.
- Under the hood: the build pipeline, what it guarantees, and how a course is set up.
- npm: npmjs.com/package/explico. The source repository is private.
explico is pre-1.0: its API can still change between minor versions, and the license is undecided.