Add instant.config.ts for self-hosted create-instant-app

[nezaj]

I noticed when using create-instant-app in a self-hosted setup the LLM would first try to use instant-cli without specifying INSTANT_CLI_API_URI which cause an error since the app doesn't exist in production. The LLM would be able to inspect the app and figure out it needs to add this env variable but I thought it would be nicer to remove that schlep.

This PR makes it so when you use create-instant-app with a custom INSTANT_CLI_API_URI we'll create an instant.config.ts file that our CLI will pick up and avoid the error from before.

As a bonus, in the self-hosted dashboard we'll also update the create-instant-app command to include both self hosted api and dash uris

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 56879912-2e3c-4b0b-adb6-eb78135edfb1

📥 Commits

Reviewing files that changed from the base of the PR and between 367cedd and 8c61217.

📒 Files selected for processing (1)

• client/packages/version/src/version.ts

---

📝 Walkthrough

Walkthrough

The dashboard now passes self-hosted API and dashboard URIs to project creation. The CLI forwards these values to applyBackendConfig, which generates instant.config.ts after successful backend configuration.

Changes

Self-hosted backend configuration

Layer / File(s)	Summary
Backend config generation and validation client/packages/create-instant-app/src/backendConfig.ts, client/packages/create-instant-app/src/backendConfig.test.ts, client/packages/version/src/version.ts	applyBackendConfig accepts an optional dashboard URI and writes instant.config.ts with normalized API and dashboard URIs. Tests cover successful and failed configuration. The shared package version changes to v1.0.63.
CLI backend wiring client/packages/create-instant-app/src/index.ts	The CLI passes INSTANT_CLI_DASH_URI to applyBackendConfig.
Dashboard project creation client/www/components/dash/HomeStartGuide.tsx, client/www/pages/dash/index.tsx	Self-hosted dashboard pages pass API and origin URIs to AppStart. Project creation commands include shell-quoted backend environment variables. Hosted deployments continue without overrides.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Home
  participant AppStart
  participant getSteps
  participant create_instant_app
  participant applyBackendConfig
  Home->>AppStart: pass self-hosted apiURI and dashURI
  AppStart->>getSteps: pass backend configuration
  getSteps->>create_instant_app: prepend shell-quoted backend environment variables
  create_instant_app->>applyBackendConfig: pass API and dashboard URIs
  applyBackendConfig->>create_instant_app: write instant.config.ts

Loading

Possibly related PRs

• instantdb/instant#2793: Uses apiURI through instant.config.ts for self-hosted backend configuration.
• instantdb/instant#2803: Extends the applyBackendConfig implementation and related tests.
• instantdb/instant#2812: Adds related dashURI and INSTANT_CLI_DASH_URI handling.

Suggested reviewers: stopachka, drew-harris

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description check	✅ Passed	The description explains the self-hosted configuration changes and the dashboard command update.
Title check	✅ Passed	The title clearly identifies the primary change: adding instant.config.ts for self-hosted create-instant-app usage.
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.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

View Vercel preview at instant-www-js-wire-self-host-uri-jsv.vercel.app.

[stopachka]

SGTM!