Skip to content

docs: Add an App publishing page for Serverpod Cloud - #922

Merged
Isakdl merged 12 commits into
mainfrom
docs/app-publishing
Nov 17, 2026
Merged

Isakdl merged 12 commits into
mainfrom
docs/app-publishing

Conversation

@Crazelu

@Crazelu Crazelu commented Nov 14, 2026 •

Copy link
Copy Markdown
Collaborator

Adds a Cloud concept page for app publishing. scloud app doctor and scloud app setup link to its sections when a check fails, so the links need a page to land on.

  • New page: /cloud/concepts/app-publishing. It is unlisted until app publishing launches, so the CLI links work but the page stays out of the sidebar and search.
  • It covers what app publishing does (iOS to TestFlight, Android to a draft release on Google Play's internal testing track), connecting the stores in the console, app setup, app doctor, app publish with dart defines, and the commands that follow builds (app list, status, show, log, artifacts, cancel).
  • A Setup requirements section has one subsection per app doctor check. The CLI links to three of its anchors: #android-release-signing, #ios-export-compliance, and #app-icon.
  • Limits: iOS and Android only, and the monthly build allowance per project.
  • The scloud.yaml schema page now documents the project.app settings: dir, flutterSdk, identifiers, and dartDefineFromFile.

Checked against the Cloud CLI, console, and Ground Control source on serverpod/serverpod_cloud main (7cd895081).

@Crazelu Crazelu self-assigned this Nov 14, 2026

@kamranbekirovyz kamranbekirovyz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Description mentions limits but couldn't see it on docs.

@Crazelu

Crazelu commented Nov 14, 2026

Copy link
Copy Markdown
Collaborator Author

Description mentions limits but couldn't see it on docs.

Resolved in 5870249

Comment thread cloud_docs/concepts/app-publishing.md Resolved
@Crazelu
Crazelu requested a review from a team November 16, 2026 11:11
@developerjamiu

developerjamiu commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

App publishing isn't available to users yet. The CLI hides the app command (app_command.dart#L322-L324), and the console hides the App Stores tab in production (project_detail_shell_connector.dart#L76). Add unlisted: true to the frontmatter until the launch. The links app doctor prints still work, but the page stays out of the sidebar and search.

@Crazelu

Crazelu commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator Author

Question: App publishing isn't available to users yet. The CLI hides the app command (app_command.dart#L322-L324), and the console hides the App Stores tab in production (project_detail_shell_connector.dart#L76). Should this wait for the launch, or merge with unlisted: true in the frontmatter? An unlisted page still works for the links app doctor prints, but stays out of the sidebar and search.

We should merge as unlisted.

@developerjamiu

developerjamiu commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

serverpod/serverpod_cloud#3198 moves the app settings in scloud.yaml under project.app, and the old keys stop working without a warning. Update appDir, flutterSdk and appIdentifiers on this page to match what ships.

@Crazelu

Crazelu commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator Author

serverpod_cloud#3198 moves the app settings in scloud.yaml under project.app, and the old keys stop working without a warning. Update appDir, flutterSdk and appIdentifiers on this page to match what ships.

Another docs PR will update that once serverpod_cloud#3198 is merged

Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
Comment thread cloud_docs/concepts/app-publishing.md Resolved
@developerjamiu

Copy link
Copy Markdown
Contributor

The description is out of date: it still lists the manual first Android build as a limit, and app doctor links to three anchors (#android-release-signing, #ios-export-compliance, #app-icon), not five.

@Crazelu

Crazelu commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator Author

Add unlisted: true to the frontmatter until the launch.

Fixed in 939dbb3

@Crazelu

Crazelu commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator Author

Update appDir, flutterSdk and appIdentifiers on this page to match what ships.

serverpod/serverpod_cloud#3198 is merged, so this PR now covers it: 62d78b5. The page also documents app setup (f3a0823) and dart defines (ad1e855).

@Crazelu

Crazelu commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator Author

The description is out of date

Updated the description.

@developerjamiu developerjamiu left a comment

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.

Hi, took another look at #922. Two things came from Cloud changes that landed today:

  1. The console’s store guides now wait for app setup to run first (serverpod_cloud#3229), but the page tells readers to connect the stores before setting up the app. Someone following the page in order gets stuck in the console..
  2. The CLI now reads project.app.xcodeVersion in scloud.yaml (serverpod_cloud#3217), and the schema page doesn’t list it yet..

I'm okay with merging this now but let's try to address these in a follow up PR.

@Isakdl
Isakdl merged commit 82c099b into main Nov 17, 2026
7 checks passed
@Isakdl
Isakdl deleted the docs/app-publishing branch November 17, 2026 16:55
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.

4 participants