Skip to content

docs: add guide for testing local CLI changes outside the monorepo - #137

Merged
miguel-heygen merged 2 commits into
mainfrom
docs/testing-local-cli
Mar 30, 2026
Merged

docs: add guide for testing local CLI changes outside the monorepo#137
miguel-heygen merged 2 commits into
mainfrom
docs/testing-local-cli

Conversation

@miguel-heygen

@miguel-heygen miguel-heygen commented Mar 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds docs/guides/testing-local-changes.mdx — a contributor guide explaining how to test unreleased CLI changes against real projects outside the monorepo.

Covers:

  • pnpm link --global (recommended — makes hyperframes in $PATH point at your local build)
  • node alias (no PATH changes)
  • npm pack (test the exact artifact that would be published)
  • Troubleshooting (which hyperframes, port conflicts, stale builds)
  • Table of test scenarios for each bug category

Also registers the page in docs/docs.json so it appears in the Guides nav.

@miguel-heygen
miguel-heygen force-pushed the docs/testing-local-cli branch from 81c3ebb to bdb2332 Compare March 30, 2026 16:57
Comment thread docs/contributing/testing-local-changes.mdx
@miguel-heygen
miguel-heygen force-pushed the docs/testing-local-cli branch 4 times, most recently from 38a4771 to dfc9420 Compare March 30, 2026 22:03
Covers pnpm link, node alias, and npm pack workflows with a
table of test scenarios for each bug fix category.
Addresses review feedback: move the local CLI testing guide out of
the Guides nav group and into the Contributing section alongside
contributing.mdx.
@miguel-heygen
miguel-heygen force-pushed the docs/testing-local-cli branch from dfc9420 to f098a71 Compare March 30, 2026 22:06
@miguel-heygen
miguel-heygen changed the base branch from fix/studio-bugs to main March 30, 2026 22:12

Copy link
Copy Markdown
Collaborator Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@miguel-heygen
miguel-heygen merged commit 0d51fb7 into main Mar 30, 2026
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants