feat(init): signpost sanity new to logged-out users

.changeset/pr-1581.md

@@ -0,0 +1,6 @@
+<!-- auto-generated -->
+---
+'@sanity/cli': minor
+---
+
+feat(init): signpost sanity new to logged-out users

packages/@sanity/cli/src/actions/init/__tests__/initAction.test.ts

@@ -201,7 +201,8 @@ describe('initAction (direct)', () => {
 
     expect(caughtError).toBeInstanceOf(InitError)
     const initError = caughtError as InitError
-    expect(initError.message).toBe(LOGIN_REQUIRED_MESSAGE)
+    expect(initError.message).toContain(LOGIN_REQUIRED_MESSAGE)
+    expect(initError.message).toContain('run `sanity new` to create a project without logging in')
     expect(initError.exitCode).toBe(1)
   })
 })

packages/@sanity/cli/src/actions/init/__tests__/newCommandBanner.test.ts

@@ -0,0 +1,42 @@
+import {afterEach, describe, expect, test, vi} from 'vitest'
+
+import {renderNewCommandBanner} from '../newCommandBanner.js'
+
+function render(): string {
+  const log = vi.fn()
+  renderNewCommandBanner({error: vi.fn() as never, log, warn: vi.fn()})
+  return (
+    log.mock.calls
+      .map(([line]) => String(line ?? ''))
+      .join('\n')
+      // eslint-disable-next-line no-control-regex -- strip ANSI styling
+      .replaceAll(/\u001B\[[0-9;]*m/g, '')
+      // eslint-disable-next-line no-control-regex -- strip OSC 8 hyperlink wrappers
+      .replaceAll(/\u001B\]8;;[^\u0007]*\u0007/g, '')
+  )
+}
+
+afterEach(() => {
+  vi.unstubAllEnvs()
+})
+
+describe('#renderNewCommandBanner', () => {
+  test('renders the two-ways-to-start signpost box, blank-line padded', () => {
+    const banner = render()
+
+    expect(banner).toContain('Two ways to start')
+    expect(banner).toContain('sanity init')
+    expect(banner).toContain('sanity new')
+    expect(banner).toContain('claim it within 72 hours')
+    expect(banner).toContain('https://sanity.new')
+    expect(banner).toContain('╭') // boxed — the one-time signpost keeps its box
+    expect(banner.startsWith('\n')).toBe(true)
+    expect(banner.endsWith('\n')).toBe(true)
+  })
+
+  test('ignores the retired SANITY_NEW_BANNER switch', () => {
+    vi.stubEnv('SANITY_NEW_BANNER', '3')
+
+    expect(render()).toContain('Two ways to start')
+  })
+})

packages/@sanity/cli/src/actions/init/initAction.ts

@@ -32,6 +32,7 @@ import {InitError} from './initError.js'
 import {flagOrDefault, shouldPrompt, writeStagingEnvIfNeeded} from './initHelpers.js'
 import {initNextJs} from './initNextJs.js'
 import {initStudio} from './initStudio.js'
+import {renderNewCommandBanner} from './newCommandBanner.js'
 import {getPlan} from './plan/getPlan.js'
 import {createProjectFromName} from './project/createProjectFromName.js'
 import {getProjectDetails} from './project/getProjectDetails.js'
@@ -397,12 +398,19 @@ async function ensureAuthenticated(
   }
 
   if (options.unattended) {
-    throw new InitError(LOGIN_REQUIRED_MESSAGE, exitCodes.RUNTIME_ERROR)
+    throw new InitError(
+      `${LOGIN_REQUIRED_MESSAGE}\n\n` +
+        'Alternatively, run `sanity new` to create a project without logging in — ' +
+        'you can claim it with a Sanity account later. See `sanity new --help`.',
+      exitCodes.RUNTIME_ERROR,
+    )
   }
 
   trace.log({step: 'login'})
   output.warn(LOGIN_REQUIRED_MESSAGE)
 
+  renderNewCommandBanner(output)
+
   try {
     await login({
       output,

packages/@sanity/cli/src/actions/init/newCommandBanner.ts

@@ -0,0 +1,36 @@
+import {styleText} from 'node:util'
+
+import {boxen} from '@sanity/cli-core/ux'
+
+import {hyperlink as link} from '../../util/terminalLink.js'
+import {type InitContext} from './types.js'
+
+const SANITY_NEW_URL = 'https://sanity.new'
+
+/**
+ * The fork-in-the-road signpost shown before init's interactive login takes over the terminal:
+ * frames `init` and `new` as two equally valid front doors. A one-time boxed moment is
+ * deliberate here — unlike the recurring claim reminders, it renders once per init run, so the
+ * box draws the eye without training anyone to skim past it. (Three prototype treatments
+ * existed behind a `SANITY_NEW_BANNER` env switch during evaluation; UAT standardized on this
+ * one and dropped the switch.)
+ */
+export function renderNewCommandBanner(output: InitContext['output']): void {
+  output.log('')
+  output.log(
+    boxen(
+      `${styleText('bold', 'Two ways to start')}
+
+${styleText('cyan', 'sanity init')}  Log in and set up a Studio ${styleText('dim', "(you're here)")}
+${styleText('cyan', 'sanity new')}   No login — mint a project now, claim it within 72 hours
+
+Learn how it works: ${link(SANITY_NEW_URL, SANITY_NEW_URL)}`,
+      {
+        borderColor: 'cyan',
+        borderStyle: 'round',
+        padding: 1,
+      },
+    ),
+  )
+  output.log('')
+}

packages/@sanity/cli/src/commands/__tests__/init/init.authentication.test.ts

@@ -206,14 +206,15 @@ describe('#init: authentication', () => {
     })
 
     expect(error?.message).toContain(LOGIN_REQUIRED_MESSAGE)
+    expect(error?.message).toContain('run `sanity new` to create a project without logging in')
     expect(error?.oclif?.exit).toBe(1)
   })
 
   test('calls login when token invalid and not in unattended mode', async () => {
     mockGetById.mockRejectedValueOnce(createHttpError(401, 'Unauthorized'))
 
     setupInitSuccessMocks()
-    const {error} = await testCommand(
+    const {error, stdout} = await testCommand(
       InitCommand,
       [
         '--dataset=test',
@@ -235,6 +236,8 @@ describe('#init: authentication', () => {
     )
 
     if (error) throw error
+    expect(stdout).toContain('Two ways to start')
+    expect(stdout).toContain('claim it within 72 hours')
     expect(mockLogin).toHaveBeenCalled()
   })