Skip to content

fix(example-app): drop vestigial tutorial-forge-cli dep (clean fresh install)#70

Merged
jbrecht merged 1 commit into
mainfrom
fix-fresh-install-bin-warning
Jun 16, 2026
Merged

fix(example-app): drop vestigial tutorial-forge-cli dep (clean fresh install)#70
jbrecht merged 1 commit into
mainfrom
fix-fresh-install-bin-warning

Conversation

@jbrecht

@jbrecht jbrecht commented Jun 16, 2026

Copy link
Copy Markdown
Owner

Pre-launch polish, found via a fresh-clone smoke test of the README quick-start.

Problem

On a fresh git clone + pnpm install, the first line of output is:

[WARN] Failed to create bin at .../packages/example-app/node_modules/.bin/tutorial-forge.
ENOENT: no such file or directory, open '.../tutorial-forge-cli/dist/main.js'

example-app declares tutorial-forge-cli as a dependency, so pnpm tries to link its tutorial-forge/tforge bins — but the CLI's dist/ isn't built at install time, so it fails. Benign (install completes; the quick-start runs the CLI via tsx ../cli/src/main.ts, not the bin; npm consumers never see it) — but it's a scary-looking warning on the exact path a HN reader takes, on their very first command.

Fix

tutorial-forge-cli is not imported anywhere in example-app — pnpm forge uses tsx on the CLI source. Removing the unused workspace dep stops pnpm from attempting the bin link.

Verified

Reproduced the fresh condition (rm -rf packages/cli/dist + pnpm install): no more Failed to create bin warning, and pnpm forge list still runs fine via tsx. The full quick-start (pnpm forge render) already produces a valid MP4 from a clean clone.

No CHANGELOG entry — example-app is private, so this doesn't touch the published packages (no republish).

🤖 Generated with Claude Code

…install)

example-app declared `tutorial-forge-cli` but never imports it — `pnpm
forge` runs the CLI via `tsx ../cli/src/main.ts` (source). The dep made
pnpm try to link the CLI's bin into example-app on install, which fails
with a scary `[WARN] Failed to create bin … ENOENT` on a fresh clone
because the CLI's dist/ isn't built yet. Harmless (the quick-start uses
tsx, and npm consumers never see it), but it's the first line of output a
repo cloner sees. Removing the unused dep eliminates it; `pnpm forge`
still works (verified via `forge list`).

Found via a fresh-clone quick-start smoke test ahead of launch.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jbrecht jbrecht merged commit fe22fba into main Jun 16, 2026
1 check 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.

1 participant