Local development — Honeydeck docs

Local development This guide explains how to test Honeydeck locally before it is published to npm. Prerequisites Honeydeck is currently developed and tested with Node 26+. Run Honeydeck from the repository From the Honeydeck repository: Root npm run dev starts the private showcase deck package and the marketing/docs site together. To run only the showcase deck: To demo the starter deck generated by honeydeck init , run: That points at the real starter template files through the source CLI: Link the local CLI From the Honeydeck package directory: Then from any folder: npm link exposes the local honeydeck command, but it does not publish Honeydeck to the npm registry. Install local Honeydeck in a generated project Until Honeydeck is published, npm install inside a generated project may fail with: This happens because the generated project depends on @honeydeck/honeydeck , but npm cannot find it in the public registry yet. For local testing, link the local Honeydeck package into the generated project: If the global link does not exist yet, create it first from the Honeydeck package directory: You can also link the package folder directly without a global link step: npm link keeps the generated project wired to your local checkout. Changes in the Honeydeck package are picked up without publishing to npm.