diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..aef06b6
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project are documented here. The format is based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres
+to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2026-07-25
+
+### Added
+
+- **Freeform mode (now the default).** Instead of picking from a fixed 12-block
+  template and 4 preset skins, the AI authors a complete, bespoke, self-contained
+  HTML page per subject — its own layout, visual system, and a working
+  interactive model of the subject's real logic. `core/build/check-html.mjs`
+  (wired up as `think-in-html check`) rejects any output that isn't fully
+  self-contained (no external scripts/stylesheets/images, CSP meta required).
+- Two worked reference examples at the freeform quality bar:
+  `examples/novus-pricing-desk.freeform.html` and
+  `examples/novus-rate-limit.freeform.html`.
+- Thinking and text input modes are now documented as fully supported (they
+  share the same schema and renderer as code mode) rather than "planned."
+- CI on GitHub Actions (Node 18/20/22) running the smoke-test suite (18 tests)
+  and a CLI help check on every push/PR.
+- A browsable example gallery (`examples/index.html`).
+- Every generated page — freeform or the legacy `--blocks` mode — must now
+  credit "Think-In-HTML" as a real hyperlink back to this repo, not just plain
+  text. Blocks mode already did this via its shared renderer; freeform mode's
+  instructions and both reference examples were fixed to match.
+
+### Changed
+
+- **Install leads with GitHub clone / `install.sh`, not npm/npx** — npm
+  publishing is paused, so `bin/cli.mjs init` no longer writes adapter
+  instructions that shell out to `npx think-in-html`. It now mirrors
+  `install.sh` exactly (copies the engine into `<project>/think-in-html/core/`,
+  rewrites adapter path references), so the two install paths can't drift
+  apart.
+- README broadened to lead with all three modes (code, thinking, text)
+  instead of code only.
+
+## [1.0.0] - initial release
+
+- Composable teaching-block lesson engine (schema v2): the AI composes an
+  ordered list of tested teaching blocks (hook, analogy, concept, code, steps,
+  flow, architecture, compare, aha, quiz, recap, glossary) instead of a fixed
+  layout. Four live-switchable visual skins (Aurora/Storybook/Blueprint/
+  Terminal), a gamified quiz with confetti, and a flip-card glossary.
+- Distributed as an npm package with a `think-in-html` CLI
+  (`build`, `init`, `instructions`, `check`, `--help`/`--version`).
+- Tool adapters for Claude Code, Cursor, and Codex.
diff --git a/package.json b/package.json
index e11947c..a3d6071 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "think-in-html",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Turn code, an AI thinking transcript, or any text into a single self-contained, interactive HTML lesson — a bespoke design and interactive model authored fresh for each subject.",
   "type": "module",
   "bin": {