From 6375467f721f52db2c98a0455957646c9228cd3c Mon Sep 17 00:00:00 2001
From: NullVoxPopuli-ai-agent
 <268630448+NullVoxPopuli-ai-agent@users.noreply.github.com>
Date: Mon, 27 Jul 2026 09:59:15 -0400
Subject: [PATCH] Install docs: how to try unreleased kolay from the dist
 branch
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A <details> under Install explains that every push to main publishes
the built package contents to the dist branch (push-dist.yml), so the
unreleased kolay can be tried with
pnpm add kolay@github:universal-ember/kolay#dist — or a pnpm override
when a workspace has multiple kolay consumers (this is how
ember-primitives previews the plugin rework, universal-ember/ember-primitives#794).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs-app/src/templates/install/index.gjs.md | 25 +++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs-app/src/templates/install/index.gjs.md b/docs-app/src/templates/install/index.gjs.md
index 8ceab3d0..82903023 100644
--- a/docs-app/src/templates/install/index.gjs.md
+++ b/docs-app/src/templates/install/index.gjs.md
@@ -28,6 +28,31 @@ pnpm add kolay
 
 [^type-module]: this library sets `type: module` in its `package.json`, which for ember projects means that it requires vite.
 
+<details>
+<summary>Trying unreleased changes (the <code>dist</code> branch)</summary>
+
+Every push to `main` publishes the built package contents to the [`dist` branch](https://github.com/universal-ember/kolay/tree/dist), so unreleased changes can be tried without waiting for a release:
+
+```bash
+pnpm add kolay@github:universal-ember/kolay#dist
+```
+
+In a workspace where other packages also depend on `kolay` (or to keep your declared semver range untouched), use an override instead, in the root `package.json`:
+
+```jsonc
+{
+  "pnpm": {
+    "overrides": {
+      "kolay": "github:universal-ember/kolay#dist",
+    },
+  },
+}
+```
+
+The install resolves the branch to its current commit and pins that in your lockfile — to pick up newer changes later, run `pnpm update kolay` (or re-run the install after removing the lockfile entry).
+
+</details>
+
 ### Use Markdown
 
 - from any folder, any project (good for monorepos)