Skip to content

docs: Rework the Quickstart into numbered steps with PATH setup - #890

Open
Roxie-32 wants to merge 7 commits into
serverpod:mainfrom
Roxie-32:update-quickstart
Open

Roxie-32 wants to merge 7 commits into
serverpod:mainfrom
Roxie-32:update-quickstart

Conversation

@Roxie-32

Copy link
Copy Markdown
  • Improved the setup steps into numbered steps, each with a result you can check.
  • Added PATH setup for macOS, Linux, and Windows, soserverpod works in every terminal.
  • Added the missing steps.
  • Rewrote the deploy steps to match the current user flow

@developerjamiu

Copy link
Copy Markdown
Contributor

The Next and 4.0.0 copies now differ, and they should match. Start from the 4.0.0 copy and bring over the Next copy's macOS and Linux PATH folders and serverpod cloud launch. My other comments apply to both copies.

Comment thread docs/04-get-started/02-quickstart.md Outdated
Comment thread docs/04-get-started/02-quickstart.md Outdated
Comment thread docs/04-get-started/02-quickstart.md Outdated
@developerjamiu

Copy link
Copy Markdown
Contributor

Use a conventional commit title, for example docs: Rework the Quickstart into numbered steps with PATH setup. Lint also fails on the double blank lines and trailing spaces it lists. It only checks docs/, so check the 4.0.0 copy by hand.

Comment thread docs/06-concepts/cli/_generated/cloud.md Outdated
Comment thread docs/04-get-started/02-quickstart.md Outdated
Comment thread docs/04-get-started/02-quickstart.md Outdated

Serverpod is tested on Mac, Windows, and Linux. Before you can install Serverpod, you need to have **[Flutter](https://flutter.dev/docs/get-started/install)** installed. Serverpod 4 requires Flutter 3.44.4 or later, which includes Dart 3.12.2.
- [Flutter](https://flutter.dev/docs/get-started/install) 3.44.4 or later, which includes Dart 3.12.2.
- An AI coding agent like Claude Code, Cursor, or GitHub Copilot.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Use the agents we've tested, and keep the platform line the old text had.

Suggested change
- An AI coding agent like Claude Code, Cursor, or GitHub Copilot.
- A Mac, Windows, or Linux computer.
- An AI coding agent, such as Antigravity, Cursor, or Claude Code.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

For platform, do we see people use platforms outside Mac, Windows, or Linux computer? These are the major platforms so it seems redundant.

Comment thread docs/04-get-started/02-quickstart.md Outdated
```bash
$ serverpod cloud launch
```
4. Follow the prompts to authenticate in the browser and select your Cloud account.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Question: the CLI has no account picker. Is "select your Cloud account" a step on the browser sign-in page?

@Roxie-32 Roxie-32 changed the title Improve the Quickstart for the new target users docs: Rework the Quickstart into numbered steps with PATH setup Oct 28, 2026

This branch has not been deployed

No deployments
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.

2 participants