docs: Add an agent setup prompt to the installation page - #872
Merged
Merged
Conversation
Adds a copyable prompt that tells a coding agent to check for and install only the missing tooling (Flutter and the Serverpod CLI), then verify it. Code block copies are now reported to Google Analytics as a `copy_code_block` event. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
SandPod
requested changes
Oct 2, 2026
SandPod
left a comment
SandPod
left a comment
Contributor
There was a problem hiding this comment.
NICE! Might be here before you are done, but I'm hyped for this. Add this to the older versions of the documentation as well.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Alexander Sandor <137198655+SandPod@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Author
|
@SandPod I appended your suggestion, I attached a screenshot of a dry-run on my machine, I also ran a test in a docker container (with nothing installed), and it worked too. |
SandPod
approved these changes
Oct 2, 2026
SandPod
left a comment
SandPod
left a comment
Contributor
There was a problem hiding this comment.
Add this to version 4 of the documentation or else it will only be visible under /next. I'll give a preliminary thumbs up because I need to run 😅
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
On the docs page:
In claude:
Adds a Set up with an AI agent section at the top of the installation page with a copyable prompt. The prompt tells a coding agent to check what is already installed, install only the missing tooling (latest stable Flutter and the Serverpod CLI), and verify with
flutter doctor,dart --version, andserverpod version. If an existing Flutter is too old for the Serverpod CLI, the agent asks before upgrading.Code block copies are now reported to Google Analytics as a
copy_code_blockevent withpage_path,language, andblock_title. The prompt block is titledAgent setup promptso its copies can be filtered.block_titleneeds to be registered as an event-scoped custom dimension in GA to break reports down by block.Testing
Ran Claude Code with an earlier version of the prompt in a bare
debian:bookworm-slimarm64 container (onlycurl,ca-certificates, andsudo). The agent installed the missing system packages, cloned Flutter stable, installed the Serverpod CLI, and all three verification commands passed in a fresh shell. That run added PATH entries only for interactive shells, so the prompt now asks for non-interactive shells too. The final wording has not been re-run.🤖 Generated with Claude Code