🦞 igor-claw: CONNECT.md — document the no-attach-existing-site CLI gap - #944
Open
ayal wants to merge 1 commit into
Open
🦞 igor-claw: CONNECT.md — document the no-attach-existing-site CLI gap#944ayal wants to merge 1 commit into
ayal wants to merge 1 commit into
Conversation
init/create/headless link always provision a brand-new site+app pair — there's no supported way to target a pre-existing siteId/clientId (e.g. from Wix's own headless onboarding). Hand-writing wix.config.json around this looks like it works (every backend REST call + wix release succeed) but the frontend never serves — the site's origin never gets registered with the platform edge, since only init/create/link reach that step. Adds a caveat telling the agent to stop and ask rather than burn a run on hand-authored-config debugging, plus the field-tested fallback: provision a fresh site+app pair via init/create and re-run Setup/Seed against it. Opened automatically by an AI agent on behalf of Ayal (ayalg@wix.com). Context: https://wix.slack.com/archives/C0BDXM5LLE7/p1786351421432449
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A user with a pre-provisioned headless site (siteId/clientId handed over by Wix's own onboarding UX before any code existed) had no supported way to attach a Wix CLI project to it.
init,create, andheadless linkall unconditionally provision a brand-new site+app pair — confirmed inwix-clisource:getHeadlessInitCommand'sinitcommand takes zero options, andcreate-headless'sCommandOptionshas nositeId/clientIdfield.Hand-writing
wix.config.jsonwith the existing, correctly-authorized siteId/appId looks like it works — every backend REST call succeeds (app install, content seed), and evenwix releaseitself reports success — but the deployed frontend never serves; Wix's edge returns a generic 404 as if the site doesn't exist. Root cause (fromwix-clisource):init'screate-project.tscalls Dev Center'supdateOAuthApp(..., redirectUrlWixPages, origin: 'other')to register the app as the site's active frontend — a step only reachable throughinit/create/link, never exposed as a standalone/repairable call. No CLI command, REST call, orwix releaseoutput flags this as missing.This is a real product/CLI gap (needs a design decision — new command/flag, or a "claim existing site" mode), so no code PR for the underlying gap. This PR instead updates the skill so a future run doesn't burn time hand-authoring a config that can't work, and instead surfaces the limitation + uses the field-tested fallback (provision a fresh site+app pair, re-seed against it).
Change
skills/wix-headless/references/managed/CONNECT.md— new caveat after §1: stop and tell the user rather than hand-writewix.config.jsonaround a pre-existing siteId, and the fallback flow that's confirmed to work.Opened automatically by an AI agent on behalf of Ayal (
ayalg@wix.com). Report thread: https://wix.slack.com/archives/C0BDXM5LLE7/p1786351421432449