Skip to content

Clarify local Connect development - #19

Merged
callumalpass merged 1 commit into
mainfrom
agent/fix-connect-local-development
Aug 9, 2026
Merged

Clarify local Connect development#19
callumalpass merged 1 commit into
mainfrom
agent/fix-connect-local-development

Conversation

@callumalpass

Copy link
Copy Markdown
Contributor

What changed

  • separate the localhost full-stack workflow from managed Connect
  • document how to start and pair the isolated local control plane and desktop profile
  • point the SDK client at the local Connect server when the app runs on loopback
  • clarify that --allow-local belongs only to static manifest validation
  • document the HTTPS manifest changes required for the managed service

Why

The previous quickstart combined a localhost manifest with https://connect.mdbase.dev. The managed service rejects HTTP manifests, so the copy-paste example could not complete authorization even though the local validator accepted it.

Developer impact

Developers now get one complete local workflow and a distinct production deployment path, without implying that the desktop application exposes an --allow-local switch.

Checks

  • pnpm test
    • Astro check: 0 errors, warnings, or hints
    • production build: 24 pages
    • specification import
    • local link and prose checks: 26 HTML files

@callumalpass
callumalpass merged commit 3e0dca2 into main Aug 9, 2026
1 check 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