# Scormly > Scormly is a free, open-source (MIT), local-first course builder that runs entirely in the > browser and exports SCORM 1.2, SCORM 2004 and cmi5 (xAPI) packages for Moodle, TalentLMS, > SCORM Cloud and virtually any standards-compliant LMS. There is no backend and no account: > courses, media and comments stay on the author's device, and packages are built client-side. Scormly is a block-based authoring tool: an author builds a course out of lessons (optionally grouped into units, such as modules or sections), and each lesson out of blocks, editing them in place (WYSIWYG) with drag-and-drop and undo/redo. The interface is in English, Ukrainian, French, Spanish and German. It works in current desktop browsers; Chrome and Edge can also save a project straight to a folder on disk. ## Where a project lives - **In the browser** (Chrome, Edge, Firefox): kept in the browser's private storage (OPFS), saved automatically, still there after a reload. One click to start. - **In a folder on disk** (Chrome, Edge; File System Access API): `project.json`, an `assets/` folder with the media, `AGENTS.md`, `user-instructions.md` and, once there are review comments, `comments.json`. Saved automatically; easy to back up, sync or put in Git. - **As a project .zip**: the same files in one archive. Any project downloads as a .zip and any browser opens one. Use it for backups, sharing with colleagues or handing to an AI assistant. A .zip of a project that is already open can update it (one undoable step) or open as new. ## Blocks - **Text:** heading (optionally with a small line above and a subtitle, to open a section), paragraph (rich text with links, lists, tables and inline images), list, quote, note / callout, columns, code, and table: four designs (grid, lines, stripes, or a panel with a colored header), highlighted or muted rows, bold text in cells, and a range copied from Excel or Google Sheets pastes straight into the cells. A table can also be shown as comparison cards, one card per column. - **Media:** image, gallery / carousel, image & text, video (captions, transcript, optional "must watch to continue"), audio, embed, attachment (downloadable file). - **Widget:** custom HTML / CSS / JavaScript, or an uploaded .html page or .zip site, for simulations, calculators and mini-games. It gets the course theme and a small CSS kit, and has "Copy instructions for AI" so a chat assistant can write the page. - **Explainers:** process diagram, step-by-step guide, timeline, comparison, cards (tiles with a label, a title and text, in a grid or as a list of terms, numbered or with one highlighted), before / after slider, tabs, accordion, flashcards, image hotspots. - **Practice and assessment:** quiz (single choice, multiple choice, matching, ordering and fill-in-the-blanks questions mixed under one Submit, with feedback and a passing score), sort-the-order and fill-in-the-blanks exercises, branching dialogue scenario (classic, chat / messenger or scene layout), reflection. - **Navigation:** Continue (reveals the rest of a lesson, or splits it into pages shown one at a time, optionally only after the tasks above it are done), divider, course outline. - Ready-made block templates and per-block styles (theme or photo backgrounds, spacing, full-width bands). ## Dialogue scenarios and the picture library A dialogue scenario has a character, branching lines and answer options, shown in one of three layouts: classic (avatar, line and buttons), chat (a messenger conversation) or scene (a background picture with a large character, the line in a speech bubble and the answers as one numbered bubble). Scormly ships a built-in library of illustrated characters (eight people with three emotions each, as busts and as waist-up scene poses), learner avatars and ten office backgrounds; picking one copies the pictures into the project, so exports need nothing else. A setup wizard walks an author through the layout, character, place and first exchange. ## Course design and export - Units group lessons in the lesson menu, cover page and course outline, numbered as "Unit 2 · Lesson 1", "Lesson 2.1" or straight through the course; the word for a unit (e.g. "Module") can be changed. - A cover page before the first lesson; 10 themes (Rose, Ocean, Forest, Sunset, Mono, Indigo, Crimson, Mint, Grape, Terminal) plus a custom accent color and corner shape; every theme keeps WCAG AA contrast. - Course settings: completion rule, pass / fail scoring, free or linear navigation, lesson progress, a custom finish message, and the language of the player's buttons and messages (English, Ukrainian, Spanish, French, German, Italian, Dutch, Portuguese, or automatic). - Accessible output aimed at WCAG 2.1 AA: keyboard and screen-reader support, captions and transcripts, a learner accessibility menu (text size, high contrast, readable spacing, reduced motion). - A pre-export check flags empty lessons, missing media, questions without a correct answer and accessibility gaps such as missing alt text or captions. - Exports: SCORM 1.2, SCORM 2004 (4th edition) and cmi5, with resume, time spent, score, pass / fail, per-quiz objectives and detailed question interactions reported to the LMS. Packages include the official schema files; SCORM output is tested on SCORM Cloud. - In-app preview of the learner view, guided tour, Q&A, release notes and keyboard shortcuts (press `?`). Installable as a web app (PWA). ## Review comments Authors and reviewers comment on any block, reply and resolve, with no accounts: a reviewer just types a name. Comments live in the project's `comments.json` (never in the course or an export) and travel in the project .zip; when a reviewer's .zip comes back, their comments merge into the author's. ## For AI assistants - Every project (folder or .zip) contains `AGENTS.md`, generated by Scormly: it documents `project.json` (the whole course as one JSON file), every block type's `data` shape, the Widget page spec and `comments.json`. An assistant can read it and then edit or write a whole course, or work through the open review comments and reply to each one. - `user-instructions.md` holds the author's own notes for AI (tone, audience, conventions); it is edited in Project settings → AI assistant and never overwritten by Scormly. - Scormly repairs a hand- or AI-edited `project.json` when it is opened (ids, types, missing fields) and reports what it fixed. - To hand a project to an assistant: download it as a .zip (or point the assistant at the project folder), ask it to follow `AGENTS.md`, then open the .zip it returns. ## Links - [Scormly](https://scormly.app/): the app and the landing page, with a live demo course - [Demo course](https://scormly.app/demo): opens a sample course with every kind of block - [Source code](https://github.com/dmmat/Scormly): MIT-licensed, React + TypeScript - [Issues](https://github.com/dmmat/Scormly/issues): bug reports and feature requests ## Optional - [Architecture](https://github.com/dmmat/Scormly/blob/main/docs/architecture.md): data model, state and undo/redo, storage, export - [Adding a block type](https://github.com/dmmat/Scormly/blob/main/docs/adding-blocks.md): how blocks are defined, rendered and exported - [AGENTS.md generator](https://github.com/dmmat/Scormly/blob/main/src/lib/agentGuide.ts): the source of the per-project guide for AI assistants