👋 New to open source?
Thanks for considering contributing to Mutiny.
This issue is intentionally beginner-friendly.
If you get stuck, ask questions in the comments.
We're happy to help.
Context
First-time Hosted can fail obscurely without npm install. scripts/dev.sh already prints tip: cd apps/web && npm install when apps/web/node_modules is missing. docs/COLD_START.md and README Troubleshooting also mention it. This issue is a verify / harden pass, not a greenfield feature.
Goal
Confirm the tip is visible on a clean tree; improve the message and/or docs only if something is still easy to miss.
Why it matters
Hosted is optional, but when someone runs ./scripts/dev.sh without Node deps, a clear tip saves a support thread.
Acceptance criteria
Suggested files
scripts/dev.sh
- Possibly
docs/COLD_START.md, README.md Troubleshooting
Out of scope
- Auto-running
npm install inside dev.sh, changing Node version requirements, frontend build pipeline
Hints
- Tip today is printed just before
npm run dev — check whether a failed npm still leaves the tip visible in the terminal scrollback.
- Prefer a slightly louder one-liner over new docs pages if COLD_START/README already cover install.
- Closing with evidence is a valid outcome.
Difficulty
XS · scripts / docs
Docs
👋 New to open source?
Thanks for considering contributing to Mutiny.
This issue is intentionally beginner-friendly.
If you get stuck, ask questions in the comments.
We're happy to help.
Context
First-time Hosted can fail obscurely without
npm install.scripts/dev.shalready printstip: cd apps/web && npm installwhenapps/web/node_modulesis missing.docs/COLD_START.mdand README Troubleshooting also mention it. This issue is a verify / harden pass, not a greenfield feature.Goal
Confirm the tip is visible on a clean tree; improve the message and/or docs only if something is still easy to miss.
Why it matters
Hosted is optional, but when someone runs
./scripts/dev.shwithout Node deps, a clear tip saves a support thread.Acceptance criteria
apps/web/node_modulesis absent (rename/move the folder briefly, run./scripts/dev.sh, restore)scripts/dev.shand/or COLD_START / README TroubleshootingSuggested files
scripts/dev.shdocs/COLD_START.md,README.mdTroubleshootingOut of scope
npm installinsidedev.sh, changing Node version requirements, frontend build pipelineHints
npm run dev— check whether a failednpmstill leaves the tip visible in the terminal scrollback.Difficulty
XS · scripts / docs
Docs