improvement(setup): land the wizard handoff on signup

A freshly provisioned deployment has no accounts and / renders the marketing
landing page, so the bare origin left operators hunting for the CTA. Single-source
the URLs and point every open-Sim handoff at /signup across all three modes.

Author: TheodoreSpeaks

scripts/setup/lifecycle.ts

@@ -8,8 +8,8 @@ import { forwardCommands, isLocalKubeContext } from './modes/k8s.ts'
 import { httpHealth } from './probes.ts'
 import * as p from './prompter.ts'
 import { glyph, theme } from './theme.ts'
+import { APP_SIGNUP_URL, APP_URL } from './urls.ts'
 
-const APP_URL = 'http://localhost:3000'
 const REALTIME_HEALTH = 'http://localhost:3002/health'
 const POSTGRES_VOLUME = 'sim-postgres-data'
 const COMPOSE_FILES = ['docker-compose.prod.yml', 'docker-compose.local.yml'] as const
@@ -258,7 +258,7 @@ function start(install: Install): void {
     dockerRun(composeArgs(install, 'up', '-d'), 'docker compose up failed', install.dir)
     spin.stop('Containers up')
     p.note(
-      [`open ${APP_URL}`, 'follow logs:  sim logs', 'stop:         sim stop'].join('\n'),
+      [`open ${APP_SIGNUP_URL}`, 'follow logs:  sim logs', 'stop:         sim stop'].join('\n'),
       'Running'
     )
     return
@@ -312,7 +312,7 @@ function restart(install: Install): void {
     spin.start('Restarting containers…')
     dockerRun(composeArgs(install, 'restart'), 'docker compose restart failed', install.dir)
     spin.stop('Containers restarted')
-    p.note(`open ${APP_URL}`, 'Running')
+    p.note(`open ${APP_SIGNUP_URL}`, 'Running')
     return
   }
   if (install.kind === 'dev') {

scripts/setup/modes/compose.ts

@@ -19,6 +19,7 @@ import {
   promptUnlocks,
 } from '../steps.ts'
 import { glyph, theme } from '../theme.ts'
+import { APP_SIGNUP_URL, APP_URL } from '../urls.ts'
 
 const REQUIRED_PORTS = [3000, 3002] as const
 
@@ -118,7 +119,7 @@ export async function runComposeMode(detection: Detection, quick: boolean): Prom
   if (!quick) {
     const storage = await promptStorage(root.vars, true)
     if (storage) Object.assign(values, storage)
-    const appUrl = root.vars.get('NEXT_PUBLIC_APP_URL') ?? 'http://localhost:3000'
+    const appUrl = root.vars.get('NEXT_PUBLIC_APP_URL') ?? APP_URL
     Object.assign(values, await promptSignInProviders(root.vars, appUrl))
     Object.assign(values, await promptEmail(root.vars))
     const security = await promptSecurity(root.vars)
@@ -152,11 +153,7 @@ export async function runComposeMode(detection: Detection, quick: boolean): Prom
 
   const spin = p.spinner()
   spin.start('Waiting for Sim to come up (first run pulls images and migrates)…')
-  const appHealthy = await waitFor(
-    () => httpHealth('http://localhost:3000/api/health'),
-    300_000,
-    3000
-  )
+  const appHealthy = await waitFor(() => httpHealth(`${APP_URL}/api/health`), 300_000, 3000)
   const realtimeHealthy =
     appHealthy && (await waitFor(() => httpHealth('http://localhost:3002/health'), 60_000, 2000))
   if (!appHealthy || !realtimeHealthy) {
@@ -165,7 +162,7 @@ export async function runComposeMode(detection: Detection, quick: boolean): Prom
       `${!appHealthy ? 'the app (:3000)' : 'realtime (:3002)'} never answered its health check.`,
       [
         `follow the logs: ${theme.command(`docker compose -f ${composeFile} logs -f`)}`,
-        'first boots on slow disks can exceed the wait — if containers are still starting, just wait and open http://localhost:3000',
+        `first boots on slow disks can exceed the wait — if containers are still starting, just wait and open ${APP_SIGNUP_URL}`,
       ]
     )
   }

scripts/setup/modes/dev.ts

@@ -21,8 +21,7 @@ import {
   promptUnlocks,
 } from '../steps.ts'
 import { glyph, theme } from '../theme.ts'
-
-const APP_URL = 'http://localhost:3000'
+import { APP_URL } from '../urls.ts'
 
 /**
  * A migrate failure on a never-migrated database means setup failed — abort.

scripts/setup/modes/k8s.ts

@@ -8,8 +8,8 @@ import { waitFor } from '../probes.ts'
 import * as p from '../prompter.ts'
 import { chatFlagValues, mothershipOverride, promptCopilotKey } from '../steps.ts'
 import { glyph, theme } from '../theme.ts'
+import { APP_SIGNUP_URL, APP_URL } from '../urls.ts'
 
-const APP_URL = 'http://localhost:3000'
 const RELEASE = 'sim-dev'
 const NAMESPACE = 'sim-dev'
 const LOCAL_CONTEXT_PREFIXES = ['kind-', 'docker-desktop', 'minikube', 'orbstack']
@@ -416,7 +416,7 @@ export async function runK8sMode(detection: Detection): Promise<void> {
 
   p.note(
     [
-      `open ${APP_URL} (needs both forwards below)`,
+      `open ${APP_SIGNUP_URL} (needs both forwards below)`,
       `pods:      kubectl --context ${shq(context)} -n ${NAMESPACE} get pods`,
       `app logs:  kubectl --context ${shq(context)} -n ${NAMESPACE} logs deploy/${RELEASE}-app --tail 50`,
       // Both, always: the app alone loads but the editor's socket has nothing to
@@ -454,7 +454,7 @@ export function forwardCommands(context: string): string[] {
  */
 async function offerPortForward(context: string): Promise<void> {
   const forward = await p.confirm({
-    message: `Port-forward now so you can open ${APP_URL}?`,
+    message: `Port-forward now so you can open ${APP_SIGNUP_URL}?`,
     initialValue: true,
   })
   if (!forward) {

scripts/setup/urls.ts

@@ -0,0 +1,12 @@
+/** Origin the wizard provisions Sim on locally, and the base for its env twins. */
+export const APP_URL = 'http://localhost:3000'
+
+/**
+ * Where the wizard tells an operator to open Sim.
+ *
+ * A freshly provisioned deployment has no accounts yet and `/` renders the
+ * marketing landing page, so handing over the bare origin leaves the operator
+ * hunting for a CTA before they can create the first account. Deep-linking to
+ * signup lands them on the one thing they can actually do.
+ */
+export const APP_SIGNUP_URL = `${APP_URL}/signup`

scripts/setup/wizard.ts

@@ -9,6 +9,7 @@ import { runK8sMode } from './modes/k8s.ts'
 import { ensurePortsFree } from './ports.ts'
 import * as p from './prompter.ts'
 import { glyph, theme } from './theme.ts'
+import { APP_SIGNUP_URL } from './urls.ts'
 
 export type WizardMode = 'compose' | 'dev' | 'k8s'
 
@@ -159,10 +160,9 @@ export async function runWizard(flags: WizardFlags): Promise<void> {
 
   if (mode !== 'k8s' && !startDevNow) await finalVerify()
 
-  const url = 'http://localhost:3000'
   p.note(
     [
-      mode === 'k8s' ? `port-forward, then open ${url}` : `open ${url}`,
+      mode === 'k8s' ? `port-forward, then open ${APP_SIGNUP_URL}` : `open ${APP_SIGNUP_URL}`,
       'manage it:  bun run sim start · stop · status · logs',
       'check your setup:  bun run sim doctor',
       mode === 'dev' && !startDevNow ? `start Sim:  bun run ${devScript}` : null,
@@ -175,7 +175,7 @@ export async function runWizard(flags: WizardFlags): Promise<void> {
   p.outro(theme.accent('Sim is ready.'))
 
   if (mode === 'compose' && process.platform === 'darwin') {
-    spawnSync('open', [url], { stdio: 'ignore' })
+    spawnSync('open', [APP_SIGNUP_URL], { stdio: 'ignore' })
   }
   if (startDevNow) {
     // dev:full binds 3000 (app) and 3002 (realtime) — resolve any conflict