Skip to content

docs: prefer local npm install#6854

Open
iamujjwalsinha wants to merge 1 commit intoanomalyco:devfrom
iamujjwalsinha:docs/issue-6851-prefer-npm-install
Open

docs: prefer local npm install#6854
iamujjwalsinha wants to merge 1 commit intoanomalyco:devfrom
iamujjwalsinha:docs/issue-6851-prefer-npm-install

Conversation

@iamujjwalsinha
Copy link
Copy Markdown

Summary

  • emphasize local npm install sst for Node projects
  • show running SST through the project package manager with npx sst dev
  • keep the global install path as the fallback for non-Node projects

Testing

  • git diff --check

Closes #6851

Copilot AI review requested due to automatic review settings May 2, 2026 06:38
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the top-level onboarding docs to prefer a local SST install for Node-based projects, aligning the README and docs landing page with the linked issue’s goal of emphasizing npm install sst over a global install.

Changes:

  • Reword the CLI installation guidance to recommend installing SST locally in Node projects.
  • Add an example showing the CLI being run after local installation with npx sst dev.
  • Keep the global installer instructions as the fallback path in both the docs index and README.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
www/src/content/docs/docs/index.mdx Updates the main docs landing page’s CLI section to prefer local installation and adds a local-run example.
README.md Mirrors the new installation guidance in the repository’s primary onboarding instructions.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
npm install sst
```

You can then run the CLI with your package manager.
Comment thread README.md
npx sst dev
```

If you are not using Node, you can install the CLI globally.
Comment on lines +279 to +281
```bash
npx sst dev
```
npx sst dev
```

If you are not using Node, you can install the CLI globally.
Or if you are not using Node, you can install it globally.
You can then run the CLI with your package manager.

```bash
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for your contribution!

can we check whether the docs support multiple tabs? maybe the starlight framework we're using already supports this, but i feel like it would be helpful to show how to run sst with pnpm, bun, and yarn

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.

Improve docs to focus more on npm install

3 participants