Skip to content

[On hold until RDK release] Document --from-source flag for module build start#5136

Open
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/add-build-start-from-source-flag
Open

[On hold until RDK release] Document --from-source flag for module build start#5136
Shannon Bradshaw (shannonbradshaw) wants to merge 1 commit into
mainfrom
claude/add-build-start-from-source-flag

Conversation

@shannonbradshaw

@shannonbradshaw Shannon Bradshaw (shannonbradshaw) commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Warning

On hold until an RDK release. --from-source merged to rdk main on 2026-07-01 (viamrobotics/rdk#6057) but is not yet in a released viam CLI — the latest release is v0.132.0 (2026-06-23), which predates the merge and does not contain the flag. Merging now would document a flag users on the current stable CLI cannot run. Hold until the flag ships in an RDK release (expected v0.133.0).

RDK #6057 adds a --from-source flag to viam module build start that packages local source and uploads it to the cloud builder. This bypasses the need for a GitHub repo or git push, making it easier to iterate during development.

New flags in --from-source mode:

  • --from-source: enable source upload mode
  • --path: path to the local source directory (default: .)
  • --wait: wait for the build to finish and surface failure logs
  • --no-progress: hide the progress spinner

Source changes

Docs changes

  • docs/cli/reference.md: Added --from-source, --path, --wait, --no-progress flags to the module build start argument table. Added example command.
  • docs/cli/build-and-deploy-modules.md: Added --from-source example to the Cloud builds section.
  • docs/build-modules/deploy-a-module.md: Updated the cloud build intro to note that --from-source does not require a GitHub repo.
  • docs/build-modules/module-reference.md: Updated the build start flags summary to include the new flags.

How I found these

  • Xref lookup: cli-xref.md maps rdk/cli/ changes to CLI docs
  • Grep matches: searched module build start, --ref, cloud build across entire docs repo; found 14 files referencing cloud builds, updated the 4 that describe build start flags or behavior

Generated by daily docs change agent


Generated by Claude Code

RDK #6057 adds a --from-source flag to `viam module build start` that
packages local source and uploads it to the cloud builder, bypassing the
need for a GitHub repo or git push. Also adds --path, --wait, and
--no-progress flags for this mode.

Updates four pages:
- cli/reference.md: add new flags to the argument table
- cli/build-and-deploy-modules.md: add --from-source example
- build-modules/deploy-a-module.md: note that --from-source does not
  require a GitHub repo
- build-modules/module-reference.md: update flags summary

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YFy4ubaHy4n3G9AXWJBi52
@netlify

netlify Bot commented Jul 2, 2026

Copy link
Copy Markdown

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 56d1c04
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6a462b90e9123100086548a2
😎 Deploy Preview https://deploy-preview-5136--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 40 (🔴 down 3 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Jul 2, 2026
@btshrewsbury-viam btshrewsbury-viam changed the title Document --from-source flag for module build start [On hold until RDK release] Document --from-source flag for module build start Jul 2, 2026
@btshrewsbury-viam

Copy link
Copy Markdown
Collaborator

🛑 Holding this until an RDK release ships --from-source.

The content is accurate — I verified every flag (--from-source, --path, --wait, --no-progress, and the "ignored when --from-source is set" notes on --ref/--token) against the merged cli/app.go. The catch is timing:

So users on the current stable CLI who run viam module build start --from-source today get an "unknown flag" error. Let's hold merge until the flag lands in a tagged RDK release (expected v0.133.0), then this can go in as-is.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants