feat(instant-start): setup starter provisioned repo on init by jomifepe · Pull Request #245 · prismicio/cli

jomifepe · 2026-07-30T12:28:28Z

Summary

extend prismic init --repo to complete Instant Start local handoff for existing degit'd projects: reconnect config, sync models (skipping the whole sync when reconnect has update/delete conflicts), remove documents/, swap hosted preview for local Development preview, set the slice simulator URL, rename package.json to the repo when the starter package matches, and mark the onboarding step done
read starter provenance from the Repository API (starter.id, starter.revision, starter.framework, starter.deploymentUrl)
remove the prismic starter download command and GitHub archive zip extraction flow
use adapter-local preview and simulator URLs as the single source of truth during handoff (Next.js, Nuxt, SvelteKit)

Test plan

npm run test (lint, types, unit)
npm run unit -- test/init.test.ts (reconnect, model-conflict warnings, and Instant Start handoff e2e via website-generator/instant-start)

Made with Cursor

Provide a single CLI flow to provision or export an Instant Start repository, download the starter, and set up local development. Co-authored-by: Cursor <cursoragent@cursor.com>

Inline the command handler, use synchronous ZIP extraction, and drop the mock-heavy orchestration test while keeping focused API and filesystem coverage. Co-authored-by: Cursor <cursoragent@cursor.com>

Co-authored-by: José Pereira <jomifepe@users.noreply.github.com>

Co-authored-by: Cursor <cursoragent@cursor.com>

Restore the standalone init command and move the paired starter handoff into a dedicated starter download namespace with repository validation, pinned GitHub download, local preview setup, and post-extract documents cleanup. Co-authored-by: Cursor <cursoragent@cursor.com>

Check for an existing localhost preview before adding one so rerunning the command does not create duplicate preview configs. Co-authored-by: Cursor <cursoragent@cursor.com>

Keep starter download independent from Website Generator while incorporating the latest CLI improvements. Co-authored-by: Cursor <cursoragent@cursor.com>

Resolve the GitHub archive URL from persisted starter provenance instead of a hardcoded commit, and reject repositories without recorded revision metadata. Co-authored-by: Cursor <cursoragent@cursor.com>

Build the GitHub archive URL directly from repository metadata and only reject repositories without starter provenance. Co-authored-by: Cursor <cursoragent@cursor.com>

Mark the Instant Start onboarding step complete only after the starter has been downloaded and configured locally, without failing setup if tracking fails. Co-authored-by: Cursor <cursoragent@cursor.com>

Read the deployment URL from repository starter metadata so download removes the exact preview configured during provisioning. Co-authored-by: Cursor <cursoragent@cursor.com>

Move Instant Start local setup to `prismic init --repo` for existing projects, removing the dedicated starter download command and zip flow. Co-authored-by: Cursor <cursoragent@cursor.com>

…ub-starter

These exports were removed during the starter download cleanup but are still required by completeStarterHandoff, which broke TypeScript and runtime preview setup. Co-authored-by: Cursor <cursoragent@cursor.com>

angeloashmore

Nice work on this! I found a few implementation issues, but the overall behavior checks out.

⚠️ #issue: Some of the code/file organization doesn't follow the project standards. I realize these aren't written anywhere, so I opened #249 to add them. I also opened a PR on top of this one to apply the organization changes: #250.

…entions (#250) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

cursor

Cursor Bugbot has reviewed your changes using high effort and found 4 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 1db41c1. Configure here.}

Derive local preview and simulator URLs from adapter config instead of hardcoding Next.js values. Rename package.json to the repo when the local project matches the starter template after handoff completes. Co-authored-by: Cursor <cursoragent@cursor.com>

Unskip starter handoff coverage now that instant-start provisioning returns starter provenance in production, and delete seeded documents before removing custom types in the no-models scenario. Co-authored-by: Cursor <cursoragent@cursor.com>

angeloashmore

Looks good! I left a few comments, but nothing blocking.

Merge origin/main for #249 file organization. Keep starter schema on slim repository client, move instantStart onboarding to onboarding.ts, drop z.pipe transform in favor of z.nullish, and use dedent for model conflict warning in init. Co-authored-by: Cursor <cursoragent@cursor.com>

jomifepe and others added 15 commits July 20, 2026 17:45

feat: add instant-start CLI command

d3d8428

Provide a single CLI flow to provision or export an Instant Start repository, download the starter, and set up local development. Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: simplify instant-start implementation

9a217be

Inline the command handler, use synchronous ZIP extraction, and drop the mock-heavy orchestration test while keeping focused API and filesystem coverage. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge remote-tracking branch 'origin/main' into jp/instant-start

2863720

Co-authored-by: José Pereira <jomifepe@users.noreply.github.com>

chore: improve Instant Start completion message

70949f0

Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: limit instant-start to exports

df32846

Co-authored-by: Cursor <cursoragent@cursor.com>

feat: route instant start through init

60352fa

Co-authored-by: Cursor <cursoragent@cursor.com>

chore: refine instant init description

fac31ec

Co-authored-by: Cursor <cursoragent@cursor.com>

feat: clean up instant start previews

9eb8dbf

Co-authored-by: Cursor <cursoragent@cursor.com>

Merge remote-tracking branch 'origin/main' into jp/instant-start

842a8a0

refactor(instant-start): download public starter

43b72a6

Co-authored-by: Cursor <cursoragent@cursor.com>

fix(starter-download): skip duplicate Development preview

3dd0d26

Check for an existing localhost preview before adding one so rerunning the command does not create duplicate preview configs. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge main into jp/instant-start-github-starter

3378f5d

Keep starter download independent from Website Generator while incorporating the latest CLI improvements. Co-authored-by: Cursor <cursoragent@cursor.com>

feat(starter): download archive from repository starter metadata

ae38848

Resolve the GitHub archive URL from persisted starter provenance instead of a hardcoded commit, and reject repositories without recorded revision metadata. Co-authored-by: Cursor <cursoragent@cursor.com>

refactor(starter): trust repository starter provenance for archive URL

31e452e

Build the GitHub archive URL directly from repository metadata and only reject repositories without starter provenance. Co-authored-by: Cursor <cursoragent@cursor.com>

cursor Bot reviewed Jul 30, 2026

View reviewed changes

Comment thread src/lib/starter.ts Outdated

jomifepe marked this pull request as draft July 30, 2026 12:34

jomifepe and others added 4 commits July 30, 2026 16:38

feat(starter): complete local handoff after download

88032e1

Mark the Instant Start onboarding step complete only after the starter has been downloaded and configured locally, without failing setup if tracking fails. Co-authored-by: Cursor <cursoragent@cursor.com>

fix(starter): derive hosted preview from provenance

cf16d38

Read the deployment URL from repository starter metadata so download removes the exact preview configured during provisioning. Co-authored-by: Cursor <cursoragent@cursor.com>

feat(init): replace starter download with degit handoff

2423c08

Move Instant Start local setup to `prismic init --repo` for existing projects, removing the dedicated starter download command and zip flow. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge remote-tracking branch 'origin/main' into jp/instant-start-gith…

01dd3e2

…ub-starter

jomifepe changed the title ~~refactor(starter): download repository's pinned GitHub revision~~ feat(instant-start): download repository's pinned GitHub revision Jul 31, 2026

jomifepe changed the title ~~feat(instant-start): download repository's pinned GitHub revision~~ feat(instant-start): setup starter provisioned repo on init Jul 31, 2026

fix(core): restore preview URL helpers for starter handoff

6fd2b04

These exports were removed during the starter download cleanup but are still required by completeStarterHandoff, which broke TypeScript and runtime preview setup. Co-authored-by: Cursor <cursoragent@cursor.com>

jomifepe self-assigned this Jul 31, 2026

jomifepe marked this pull request as ready for review July 31, 2026 17:50

angeloashmore mentioned this pull request Jul 31, 2026

refactor(init): reorganize starter handoff per file organization conventions #250

Merged

4 tasks

angeloashmore requested changes Jul 31, 2026

View reviewed changes

Comment thread src/lib/starter.ts Outdated

Comment thread src/commands/init.ts Outdated

refactor(init): reorganize starter handoff per file organization conv…

1db41c1

…entions (#250) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

cursor Bot reviewed Aug 3, 2026

View reviewed changes

Comment thread src/commands/init.ts

Comment thread src/commands/init.ts

Comment thread src/commands/init.ts

Comment thread src/commands/init.ts Outdated

jomifepe and others added 2 commits August 3, 2026 11:48

refactor: rename

46ce957

jomifepe requested a review from angeloashmore August 3, 2026 12:07

angeloashmore approved these changes Aug 3, 2026

View reviewed changes

Comment thread src/commands/init.ts

Comment thread src/commands/init.ts Outdated

Comment thread src/lib/prismic/clients/repository.ts Outdated

jomifepe merged commit 74454bd into main Aug 4, 2026
15 checks passed

jomifepe deleted the jp/instant-start-github-starter branch August 4, 2026 13:18

github-actions Bot mentioned this pull request Aug 4, 2026

chore(main): release 1.15.0 #254

Open

Navigation Menu

Uh oh!

feat(instant-start): setup starter provisioned repo on init - #245

feat(instant-start): setup starter provisioned repo on init#245
jomifepe merged 25 commits into
mainfrom
jp/instant-start-github-starter

jomifepe commented Jul 30, 2026 •

edited

Loading

Uh oh!

Uh oh!

angeloashmore left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

angeloashmore left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

jomifepe commented Jul 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

Uh oh!

angeloashmore left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

angeloashmore left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jomifepe commented Jul 30, 2026 •

edited

Loading

angeloashmore left a comment •

edited

Loading