Skip to content

[codex] document Capgo Build infrastructure#652

Merged
riderx merged 2 commits into
mainfrom
codex/capgo-build-m4-docs
May 9, 2026
Merged

[codex] document Capgo Build infrastructure#652
riderx merged 2 commits into
mainfrom
codex/capgo-build-m4-docs

Conversation

@riderx
Copy link
Copy Markdown
Member

@riderx riderx commented May 8, 2026

Summary

  • Adds Mac Mini Silicon M4 infrastructure specs to the Capgo Build docs.
  • Adds a visible infrastructure section to the native build marketing page.
  • Updates related shared marketing copy and touched CLI examples to use bun/bunx.

Impact

Customers can see which build machines and toolchains Capgo Build uses, including macOS Tahoe 26.2, Xcode 26.2, Android Studio 2025, and Visual Studio for Mac with .NET 9/10 workloads.

Validation

  • bunx prettier --write apps/shared/copy/messages.ts apps/web/src/pages/native-build.astro apps/docs/src/content/docs/docs/cli/cloud-build/index.mdx apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx
  • bun run check
  • Headless screenshot verification of /native-build/ showing the new infrastructure section.

Summary by CodeRabbit

Documentation

  • Updated cloud-build and native-build documentation with Mac Mini Silicon M4 build infrastructure details
  • Added comprehensive build machine, CPU, memory, and toolchain specifications
  • Updated command examples from npm/npx to bun/bunx throughout guides

Style

  • Updated build-related messaging and copy across documentation and website

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 8, 2026

Review Change Stack

Warning

Rate limit exceeded

@riderx has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 10 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ebb91e63-63e4-4ad5-a74c-7fc54083582b

📥 Commits

Reviewing files that changed from the base of the PR and between 10f97cf and 8e5506b.

📒 Files selected for processing (3)
  • apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx
  • apps/docs/src/content/docs/docs/cli/cloud-build/index.mdx
  • apps/shared/copy/messages.ts
📝 Walkthrough

Walkthrough

This PR updates Capgo's build infrastructure messaging and documentation to emphasize Mac Mini Silicon M4 build machines while standardizing CLI tooling references from npm/npx to bun/bunx across getting-started guides, overviews, copy strings, and UI components.

Changes

Infrastructure Messaging & Bun CLI Migration

Layer / File(s) Summary
Core Messaging & Copy Strings
apps/shared/copy/messages.ts
Native build pricing, cloud build description, security specs, and builder infrastructure copy all updated to reference Mac Mini Silicon M4. Linting and deployment command examples changed from npm/npx to bun/bunx.
Web Infrastructure Display
apps/web/src/pages/native-build.astro
New infrastructureSpecs constant and "Infrastructure" section added to native-build page, displaying localized hardware specs (model, CPU, GPU, neural engine, memory, OS) and toolchain details.
Build Overview Documentation
apps/docs/src/content/docs/docs/cli/cloud-build/index.mdx
iOS/Android capability bullets revised to describe both platforms running on Mac Mini Silicon M4 fleet; new "Build Machines and Toolchain" section includes hardware and tool versions table; pricing section removes cost-multiplier language and adds Mac Mini M4 context.
Getting Started CLI & Workflow
apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx
Build server flowchart label updated to "Mac Mini Silicon M4 Build Server"; all commands migrated from npm/npx to bun/bunx; new "Build Infrastructure" section details Mac Mini M4 specs; responsibility/timeline guidance clarified to require bun run build and bunx cap sync before cloud builds; CI/CD and local-dev snippets updated.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • Cap-go/website#649: Refactors the native-build.astro page that this PR extends with infrastructure specs display.
  • Cap-go/website#623: Updates shared copy strings in messages.ts, overlapping with the messaging changes in this PR.

Poem

🐰 The bunny builds with Silicon M4,
Where bun outpaces npm evermore,
Infrastructure gleams from docs so bright,
Mac Mini magic, infrastructure in sight,
Sync once, build thrice, let the builders take flight!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title '[codex] document Capgo Build infrastructure' clearly and concisely summarizes the primary change: documenting the Capgo Build infrastructure details, including Mac Mini Silicon M4 specs, across multiple documentation and marketing files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/capgo-build-m4-docs

Comment @coderabbitai help to get the list of available commands and usage tips.

@riderx riderx marked this pull request as ready for review May 8, 2026 17:41
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 10f97cfb1a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx
@riderx
Copy link
Copy Markdown
Member Author

riderx commented May 8, 2026

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 8, 2026

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx`:
- Around line 51-52: The docs use two variants of the CLI invocation;
standardize all occurrences to include the `@latest` tag by replacing instances
like "bunx `@capgo/cli` build credentials save" with the "@latest" form (e.g.,
"bunx `@capgo/cli`@latest ...") across this file so examples are consistent—update
every example string that begins with "bunx `@capgo/cli`" to "bunx
`@capgo/cli`@latest" (check other similar command lines such as the
build/credentials/save invocation and the other listed examples).

In `@apps/shared/copy/messages.ts`:
- Line 1794: Update the message string identified by
native_build_builder_infra_toolchain to remove the retired "Visual Studio for
Mac" reference and replace it with a currently supported .NET toolchain (for
example: "Visual Studio (Windows) — e.g., Visual Studio 2022/2023 — or the
dotnet CLI") while preserving the rest of the sentence about Xcode 26.2, Android
Studio 2025, and .NET 9/.NET 10 workloads so the text reads clearly and
accurately.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 705ca6ea-705c-41e5-a84f-1d08fb2d35fb

📥 Commits

Reviewing files that changed from the base of the PR and between dce89b0 and 10f97cf.

📒 Files selected for processing (4)
  • apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx
  • apps/docs/src/content/docs/docs/cli/cloud-build/index.mdx
  • apps/shared/copy/messages.ts
  • apps/web/src/pages/native-build.astro

Comment thread apps/docs/src/content/docs/docs/cli/cloud-build/getting-started.mdx Outdated
Comment thread apps/shared/copy/messages.ts Outdated
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@riderx riderx merged commit 3a9dd72 into main May 9, 2026
8 checks passed
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