Skip to content

fix(docs): describe which surfaces the NEXT_PUBLIC_ flag twins still gate - #7465

Merged
icecrasher321 merged 4 commits into
stagingfrom
docs/deployment-flag-twins
Sep 4, 2026
Merged

fix(docs): describe which surfaces the NEXT_PUBLIC_ flag twins still gate#7465
icecrasher321 merged 4 commits into
stagingfrom
docs/deployment-flag-twins

Conversation

@icecrasher321

Copy link
Copy Markdown
Collaborator

Summary

  • The self-hosting and enterprise docs said the NEXT_PUBLIC_ flag twins decide what the settings UI shows. Since fix(config): resolve the deployment shape on the server and read it through one client reader #7461 a workspace reads the server-resolved deployment configuration, so settings sections and block fields follow the server variable. The twins still gate what renders before a workspace loads: the login page's SSO entry point and the Function block's Sandbox selector. sim-setup doctor checks each pair.
  • Rewrites the master-switch explanation and the two troubleshooting bullets in the self-hosted enterprise guide, the NEXT_PUBLIC_SANDBOXES_ENABLED descriptions in the Sandboxes, Security, and Environment variables pages, and the data drains and verified domains notes that credited the twin with showing or hiding a settings page.

Type of Change

  • Documentation

Testing

  • bun run type-check in apps/docs (fumadocs-mdx compile), bun run lint, bun run check:audits, bun run docs-manifest:check all pass

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

…gate

The workspace host context now carries the server-resolved deployment shape, so settings sections and block fields inside a workspace follow the server variable. The NEXT_PUBLIC_ twins still gate the login page's SSO entry point and the Function block's Sandbox selector, and sim-setup doctor checks each pair. Update the sentences that said the twin decides what the settings UI shows.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 4, 2026 12:34am UTC

Request Review

@greptile-apps

greptile-apps Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR clarifies which settings and block surfaces use server-resolved deployment configuration and which remain gated by browser-side NEXT_PUBLIC_ twins.

  • Corrects Sandboxes documentation to distinguish server readiness, the persistent settings-sidebar entry, and the Function block’s client-gated selector.
  • Updates enterprise feature and troubleshooting guidance to describe server-side settings visibility and pre-workspace browser gates.

Confidence Score: 5/5

The documentation changes appear safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
apps/docs/content/docs/platform/self-hosting/sandboxes.mdx The revised visibility and readiness descriptions align with the current Sandboxes navigation and Function-block behavior.
apps/docs/content/docs/platform/enterprise/self-hosted.mdx The guide now distinguishes server-resolved workspace surfaces from the remaining browser-side gates.
apps/docs/content/docs/platform/self-hosting/security.mdx The Sandbox security guidance consistently describes Shell, settings, and selector gating.

Reviews (4): Last reviewed commit: "fix(docs): state the resolved flag condi..." | Re-trigger Greptile

Comment thread apps/docs/content/docs/platform/self-hosting/sandboxes.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated

@cubic-dev-ai cubic-dev-ai Bot 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.

All reported issues were addressed across 6 files

Re-trigger cubic

Comment thread apps/docs/content/docs/platform/self-hosting/environment-variables.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx
Comment thread apps/docs/content/docs/platform/self-hosting/sandboxes.mdx Outdated
Comment thread apps/docs/content/docs/platform/self-hosting/sandboxes.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated
…scope

The Sandboxes settings entry keeps its sidebar row and shows an upgrade notice until the server's readiness check passes, so say that instead of claiming the section is hidden, and add a troubleshooting bullet for that state. Describe NEXT_PUBLIC_SANDBOXES_ENABLED as an assertion the operator makes rather than a copy of readiness, invoke the setup doctor as npx sim-setup doctor throughout, and qualify its diagnostic mentions to Compose installs and source checkouts.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@greptile

@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@icecrasher321 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot 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.

All reported issues were addressed across 6 files

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread apps/docs/content/docs/platform/enterprise/data-drains.mdx Outdated
Comment thread apps/docs/content/docs/platform/self-hosting/security.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated
…Sandbox check

ENTERPRISE_ENABLED resolves data drains and the Sandbox entitlement on without the per-feature flag, so describe the off state as the feature resolving off rather than the flag being unset. The setup doctor compares NEXT_PUBLIC_SANDBOXES_ENABLED with the selected provider's readiness rather than with SANDBOXES_ENABLED, so say that instead of promising a pair check.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@greptile

@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@icecrasher321 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot 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.

All reported issues were addressed across 6 files

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread apps/docs/content/docs/platform/self-hosting/sandboxes.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated
Comment thread apps/docs/content/docs/platform/enterprise/self-hosted.mdx Outdated
…r exception

Describe the Sandbox entitlement by how the flags resolve, since an explicit SANDBOXES_ENABLED=false overrides the master switch. Say an unset or false twin hides the login page's SSO entry point and the Sandbox selector, name that selector as the one block field that still reads the browser's own configuration, and scope the remaining setup doctor mentions to Compose installs and source checkouts.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@greptile

@icecrasher321

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@icecrasher321 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot 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.

No issues found across 6 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Re-trigger cubic

@icecrasher321
icecrasher321 merged commit 69ba68b into staging Sep 4, 2026
6 checks passed
@icecrasher321
icecrasher321 deleted the docs/deployment-flag-twins branch September 4, 2026 00:36
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.

1 participant