Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

feat(desktop-app): offer Evenfire hosting in the onboarding questionnaire

Andy Paviad1f6c1417152
diff --git a/desktop-app/src/__tests__/appService.onboarding.test.ts b/desktop-app/src/__tests__/appService.onboarding.test.ts
index 726e405cb..c84f087c4 100644
--- a/desktop-app/src/__tests__/appService.onboarding.test.ts
+++ b/desktop-app/src/__tests__/appService.onboarding.test.ts
@@ -36,6 +36,7 @@ async function makeService(healthAt: HealthByUrl) {
authClient: { healthAt: ReturnType<typeof vi.fn> }
probeLocalhostReachable: () => Promise<boolean>
openDeploymentDocs: () => Promise<{ opened: true }>
+ openHostedSignup: () => Promise<{ opened: true }>
}
service.authClient = { healthAt: vi.fn(healthAt) } as never
return service
@@ -119,4 +120,24 @@ describe('onboarding main-process surface', () => {
expect(opened).not.toMatch(/minikube|quickstart/i)
})
})
+
+ describe('openHostedSignup', () => {
+ it('opens the build-time hosted URL, taking no argument', async () => {
+ const service = await makeService(healthReachableFor())
+
+ expect(await service.openHostedSignup()).toEqual({ opened: true })
+ expect(openExternal).toHaveBeenCalledTimes(1)
+ expect(String(openExternal.mock.calls[0]?.[0] || '')).toMatch(/^https:\/\//)
+ })
+
+ it('is a distinct destination from the deployment docs', async () => {
+ const service = await makeService(healthReachableFor())
+
+ await service.openHostedSignup()
+ await service.openDeploymentDocs()
+
+ const [hosted, docs] = openExternal.mock.calls.map(call => String(call[0] || ''))
+ expect(hosted).not.toBe(docs)
+ })
+ })
})
diff --git a/desktop-app/src/appService.ts b/desktop-app/src/appService.ts
index 72b9e17c8..73c4bc792 100644
--- a/desktop-app/src/appService.ts
+++ b/desktop-app/src/appService.ts
@@ -1787,6 +1787,17 @@ export class AppService {
return { opened: true }
}
+ /**
+ * Open the hosted Evenfire site for onboarding's hosted path (spec §5.3).
+ * Also a build-time constant. No credentials, no tenant name and no nonce
+ * cross this boundary — the app only opens a page.
+ */
+ async openHostedSignup(): Promise<{ opened: true }> {
+ const { shell } = await import('electron')
+ await shell.openExternal(config.hostedSignupUrl)
+ return { opened: true }
+ }
+
/** True iff `<baseUrl>/health` returns `{ status: 'ok' }` within the probe bound. */
private async probeBackendHealthy(baseUrl: string): Promise<boolean> {
if (!baseUrl?.trim()) return false
diff --git a/desktop-app/src/config.ts b/desktop-app/src/config.ts
index 53a4b05d6..9678fc815 100644
--- a/desktop-app/src/config.ts
+++ b/desktop-app/src/config.ts
@@ -16,6 +16,7 @@ type DesktopConfig = Omit<DesktopRuntimeConfig, 'appName' | 'rpcProxyBaseUrl'> &
desktopProfileUiBaseUrl: string
desktopProfileUiBaseUrlExplicit: boolean
deploymentDocsUrl: string
+ hostedSignupUrl: string
requestTimeoutMs: number
gfsUploadTimeoutMs: number
appName: string
@@ -55,6 +56,12 @@ const LOCALHOST_RPC_PROXY_BASE_URL = 'http://127.0.0.1:8094'
// already allows overrides, so a packaged build cannot be pointed elsewhere.
const DEFAULT_DEPLOYMENT_DOCS_URL =
'https://github.com/evenfire-ai/evenfire#deploying-to-a-remote-cluster'
+// Where onboarding's hosted path sends the user (spec §5.3). Today this is the
+// marketing site, not a signup endpoint: there is no tenant provisioning and no
+// evenfire://desktop-environment handoff yet, so the hosted step links out and
+// offers the manual-address fallback for when the user returns with a server.
+// Same build-time-constant rule as the docs URL.
+const DEFAULT_HOSTED_SIGNUP_URL = 'https://evenfire.ai'
const RUNTIME_CONFIG_DIR_NAME = 'runtime-configs'
/**
* Dev switch for previewing the first-run onboarding flow (spec §5.1) on a
@@ -619,6 +626,9 @@ export const config: DesktopConfig = {
deploymentDocsUrl: canUseEnvRuntimeConfig
? requiredOrDefault('DEPLOYMENT_DOCS_URL', DEFAULT_DEPLOYMENT_DOCS_URL)
: DEFAULT_DEPLOYMENT_DOCS_URL,
+ hostedSignupUrl: canUseEnvRuntimeConfig
+ ? requiredOrDefault('HOSTED_SIGNUP_URL', DEFAULT_HOSTED_SIGNUP_URL)
+ : DEFAULT_HOSTED_SIGNUP_URL,
requestTimeoutMs: Number(requiredOrDefault('REQUEST_TIMEOUT_MS', '60000')),
// Generous deadline for legacy JSON GFS uploads: a 16 MiB file is a ~22.4 MiB
// base64 body, ~60s alone on a slow uplink. v2 streams binary indexed parts and
diff --git a/desktop-app/src/ipc.ts b/desktop-app/src/ipc.ts
index c969bacbb..2ba326d4b 100644
--- a/desktop-app/src/ipc.ts
+++ b/desktop-app/src/ipc.ts
@@ -259,6 +259,10 @@ export function registerIpcHandlers(service: AppService): void {
assertTrustedSender(event)
return service.openDeploymentDocs()
})
+ ipcMain.handle('auth:openHostedSignup', async event => {
+ assertTrustedSender(event)
+ return service.openHostedSignup()
+ })
ipcMain.handle('auth:startDesktopSetup', async (event, payload: { email: string }) => {
assertTrustedSender(event)
return service.startDesktopSetup(sanitizeString(payload?.email).toLowerCase())
diff --git a/desktop-app/src/preload.ts b/desktop-app/src/preload.ts
index a4d62ffe4..90013d08c 100644
--- a/desktop-app/src/preload.ts
+++ b/desktop-app/src/preload.ts
@@ -88,6 +88,7 @@ const clerum = Object.freeze({
diagnoseLoginBackend: () => ipcRenderer.invoke('auth:diagnoseLoginBackend'),
probeLocalhostReachable: () => ipcRenderer.invoke('auth:probeLocalhostReachable'),
openDeploymentDocs: () => ipcRenderer.invoke('auth:openDeploymentDocs'),
+ openHostedSignup: () => ipcRenderer.invoke('auth:openHostedSignup'),
startDesktopSetup: (email: string) => ipcRenderer.invoke('auth:startDesktopSetup', { email }),
openForgotPassword: (email?: string) =>
ipcRenderer.invoke('auth:openForgotPassword', { email }),
diff --git a/desktop-app/src/renderer.d.ts b/desktop-app/src/renderer.d.ts
index c28f33feb..e66736d8d 100644
--- a/desktop-app/src/renderer.d.ts
+++ b/desktop-app/src/renderer.d.ts
@@ -77,6 +77,7 @@ declare global {
diagnoseLoginBackend: () => Promise<LoginBackendHint | null>
probeLocalhostReachable: () => Promise<boolean>
openDeploymentDocs: () => Promise<{ opened: true }>
+ openHostedSignup: () => Promise<{ opened: true }>
startDesktopSetup: (email: string) => Promise<{ profileUiUrl: string; appName: string }>
openForgotPassword: (email?: string) => Promise<{ profileUiUrl: string }>
openProfileSettings: (
diff --git a/desktop-app/ui/src/hooks/domain/__tests__/useOnboardingController.test.tsx b/desktop-app/ui/src/hooks/domain/__tests__/useOnboardingController.test.tsx
index f9ded9b87..093152f7f 100644
--- a/desktop-app/ui/src/hooks/domain/__tests__/useOnboardingController.test.tsx
+++ b/desktop-app/ui/src/hooks/domain/__tests__/useOnboardingController.test.tsx
@@ -33,13 +33,27 @@ describe('useOnboardingController', () => {
expect(result.current.canGoBack).toBe(false)
})
- it('skips Q2 while the hosted path is unavailable', () => {
+ it('sends "just getting started" to Q2, where hosting is offered', () => {
const { result } = renderHook(() => useOnboardingController())
- expect(result.current.hostedAvailable).toBe(false)
+ expect(result.current.hostedAvailable).toBe(true)
act(() => result.current.answerOrigin('gettingStarted'))
+ expect(result.current.step).toBe('runStyle')
+ })
+
+ it('routes each Q2 answer to its own step', () => {
+ const { result } = renderHook(() => useOnboardingController())
+
+ act(() => result.current.answerOrigin('gettingStarted'))
+ act(() => result.current.answerRunStyle('hosted'))
+ expect(result.current.step).toBe('hosted')
+
+ act(() => result.current.back())
+ expect(result.current.step).toBe('runStyle')
+
+ act(() => result.current.answerRunStyle('selfHosted'))
expect(result.current.step).toBe('selfHosted')
})
@@ -47,6 +61,7 @@ describe('useOnboardingController', () => {
const { result } = renderHook(() => useOnboardingController())
act(() => result.current.answerOrigin('gettingStarted'))
+ act(() => result.current.answerRunStyle('hosted'))
act(() => result.current.goToManual())
expect(result.current.canGoBack).toBe(true)
diff --git a/desktop-app/ui/src/hooks/domain/useOnboardingController.ts b/desktop-app/ui/src/hooks/domain/useOnboardingController.ts
index b381ca906..b6796860a 100644
--- a/desktop-app/ui/src/hooks/domain/useOnboardingController.ts
+++ b/desktop-app/ui/src/hooks/domain/useOnboardingController.ts
@@ -7,14 +7,16 @@ import type {
} from '@pages/OnboardingPage/types'
/**
- * Whether the hosted trial path (spec §5.3) is reachable in this build.
+ * Whether the hosted path (spec §5.3) is offered in Q2.
*
- * False until the hosted signup project exists: Q2 would otherwise offer a
- * choice with one real answer. While false, Q1's "just getting started"
- * routes straight to the self-hosted step. Flipping this to true is the only
- * change this file needs when path A ships (spec §7.1).
+ * True: hosting is the first thing someone just getting started should see,
+ * and the hosted step has somewhere real to send them — the Evenfire site.
+ * It is a link-out, not an in-app signup, because tenant provisioning and the
+ * deep-link handoff do not exist yet (see `steps/Hosted.tsx`). Setting this to
+ * false collapses Q2 and routes "just getting started" straight to
+ * self-hosting.
*/
-const HOSTED_SIGNUP_AVAILABLE = false
+const HOSTED_SIGNUP_AVAILABLE = true
interface OnboardingState {
step: OnboardingStep
@@ -52,10 +54,7 @@ export function useOnboardingController(): OnboardingViewModel {
const answerRunStyle = useCallback(
(answer: OnboardingRunStyleAnswer) => {
- // 'hosted' gets its own waiting step in the PR that ships path A
- // (spec §5.3). Until then Q2 is never rendered, so only 'selfHosted'
- // can arrive here.
- if (answer === 'selfHosted') goTo('selfHosted')
+ goTo(answer === 'hosted' ? 'hosted' : 'selfHosted')
},
[goTo]
)
diff --git a/desktop-app/ui/src/pages/OnboardingPage/index.tsx b/desktop-app/ui/src/pages/OnboardingPage/index.tsx
index ca7efde3d..40a1e4fb3 100644
--- a/desktop-app/ui/src/pages/OnboardingPage/index.tsx
+++ b/desktop-app/ui/src/pages/OnboardingPage/index.tsx
@@ -1,5 +1,6 @@
import { RuntimeConfigDock } from '@components/RuntimeConfigDock'
import { formatDesktopAppVersionTooltip, useDesktopAppInfo } from '@hooks/useDesktopAppInfo'
+import { Hosted } from './steps/Hosted'
import { InvitedMember } from './steps/InvitedMember'
import { ManualEnvironment } from './steps/ManualEnvironment'
import { PathChoice } from './steps/PathChoice'
@@ -39,6 +40,7 @@ export function OnboardingPage({ onboarding }: OnboardingPageProps) {
<PathChoice step={step} onAnswerOrigin={answerOrigin} onAnswerRunStyle={answerRunStyle} />
) : null}
{step === 'invited' ? <InvitedMember /> : null}
+ {step === 'hosted' ? <Hosted onContinue={goToManual} /> : null}
{step === 'selfHosted' ? <SelfHosted onContinue={goToManual} /> : null}
{step === 'manual' ? <ManualEnvironment /> : null}
diff --git a/desktop-app/ui/src/pages/OnboardingPage/steps/Hosted.tsx b/desktop-app/ui/src/pages/OnboardingPage/steps/Hosted.tsx
new file mode 100644
index 000000000..df03a7e30
--- /dev/null
+++ b/desktop-app/ui/src/pages/OnboardingPage/steps/Hosted.tsx
@@ -0,0 +1,32 @@
+import { LinkOutStep } from './LinkOutStep'
+
+interface HostedProps {
+ /** Continue into the manual environment step, which owns the submit path. */
+ onContinue: () => void
+}
+
+/**
+ * Path A — Evenfire-hosted (spec §5.3), in its link-out form.
+ *
+ * The hosted signup project does not exist yet: there is no tenant
+ * provisioning and no `evenfire://desktop-environment` handoff back into the
+ * app. So this step links to the hosted site and offers the manual-address
+ * fallback for when the user returns with a server, rather than promising an
+ * in-app signup the product cannot complete. When hosted signup ships, this
+ * step gains the `state` nonce and the waiting screen; the questionnaire above
+ * it does not change.
+ */
+export function Hosted({ onContinue }: HostedProps) {
+ return (
+ <LinkOutStep
+ title="Evenfire hosts it for you"
+ body="We run and operate Evenfire for you — no cluster to deploy or maintain. See what's available on the Evenfire site, then come back and connect with your server's address."
+ channel="openHostedSignup"
+ linkLabel="See hosted Evenfire"
+ successMessage="Evenfire opened in your browser."
+ errorMessage="The Evenfire site could not be opened"
+ continueLabel="I have a server — enter its address"
+ onContinue={onContinue}
+ />
+ )
+}
diff --git a/desktop-app/ui/src/pages/OnboardingPage/steps/LinkOutStep.tsx b/desktop-app/ui/src/pages/OnboardingPage/steps/LinkOutStep.tsx
new file mode 100644
index 000000000..01c65938a
--- /dev/null
+++ b/desktop-app/ui/src/pages/OnboardingPage/steps/LinkOutStep.tsx
@@ -0,0 +1,74 @@
+import { useState } from 'react'
+import { useAuthContext } from '@contexts/AuthContext'
+import { Button } from '@components/Common'
+
+/** No-argument main-process calls that open a build-time URL in the browser. */
+type LinkOutChannel = 'openDeploymentDocs' | 'openHostedSignup'
+
+interface LinkOutStepProps {
+ title: string
+ body: string
+ channel: LinkOutChannel
+ linkLabel: string
+ successMessage: string
+ errorMessage: string
+ continueLabel: string
+ onContinue: () => void
+}
+
+/**
+ * Shared shell for the two onboarding steps that hand off to the browser and
+ * then wait for the user to come back with an address — self-hosted (§5.4) and
+ * hosted (§5.3). Both open a URL the main process owns and both fall back to
+ * the manual environment step, so they differ only in copy.
+ */
+export function LinkOutStep({
+ title,
+ body,
+ channel,
+ linkLabel,
+ successMessage,
+ errorMessage,
+ continueLabel,
+ onContinue,
+}: LinkOutStepProps) {
+ const { busy, setStatus } = useAuthContext()
+ const [opening, setOpening] = useState(false)
+
+ const handleOpen = async () => {
+ if (opening) return
+ setOpening(true)
+ try {
+ // Vite can hot-reload renderer code while Electron still runs an older
+ // preload script, matching the guard on the environment delete action.
+ const open = window.clerum.auth[channel]
+ if (typeof open !== 'function') {
+ throw new Error('Restart the desktop app to finish loading this link')
+ }
+ await open()
+ setStatus(successMessage, 'success', undefined, { global: false, toast: true })
+ } catch (error) {
+ setStatus(
+ `${errorMessage}: ${error instanceof Error ? error.message : String(error)}`,
+ 'error'
+ )
+ } finally {
+ setOpening(false)
+ }
+ }
+
+ return (
+ <>
+ <h1>{title}</h1>
+ <p className="muted">{body}</p>
+ <div className="auth-flow-card__actions">
+ <Button block disabled={busy || opening} onClick={() => void handleOpen()}>
+ {linkLabel}
+ </Button>
+ <Button block disabled={busy} onClick={onContinue} variant="soft">
+ {continueLabel}
+ </Button>
+ </div>
+ </>
+ )
+}
diff --git a/desktop-app/ui/src/pages/OnboardingPage/steps/PathChoice.tsx b/desktop-app/ui/src/pages/OnboardingPage/steps/PathChoice.tsx
index 32b75216b..8540c234e 100644
--- a/desktop-app/ui/src/pages/OnboardingPage/steps/PathChoice.tsx
+++ b/desktop-app/ui/src/pages/OnboardingPage/steps/PathChoice.tsx
@@ -26,7 +26,7 @@ export function PathChoice({ step, onAnswerOrigin, onAnswerRunStyle }: PathChoic
>
<span className="onboarding-option__title">Evenfire hosts it for me</span>
<span className="onboarding-option__hint">
- Free for 1 week. Nothing to deploy or operate.
+ We run and operate it for you. Nothing to deploy.
</span>
</SelectableOption>
<SelectableOption
@@ -75,7 +75,7 @@ export function PathChoice({ step, onAnswerOrigin, onAnswerRunStyle }: PathChoic
onClick={() => onAnswerOrigin('gettingStarted')}
>
<span className="onboarding-option__title">No, I’m just getting started</span>
- <span className="onboarding-option__hint">See what it takes to run Evenfire.</span>
+ <span className="onboarding-option__hint">See your options for running Evenfire.</span>
</SelectableOption>
</div>
</>
diff --git a/desktop-app/ui/src/pages/OnboardingPage/steps/SelfHosted.tsx b/desktop-app/ui/src/pages/OnboardingPage/steps/SelfHosted.tsx
index 7036a2816..6dd320e73 100644
--- a/desktop-app/ui/src/pages/OnboardingPage/steps/SelfHosted.tsx
+++ b/desktop-app/ui/src/pages/OnboardingPage/steps/SelfHosted.tsx
@@ -1,6 +1,4 @@
-import { useState } from 'react'
-import { useAuthContext } from '@contexts/AuthContext'
-import { Button } from '@components/Common'
+import { LinkOutStep } from './LinkOutStep'
interface SelfHostedProps {
/** Continue into the manual environment step, which owns the submit path. */
@@ -17,50 +15,16 @@ interface SelfHostedProps {
* self-hosting means any cluster the user controls, remote or local.
*/
export function SelfHosted({ onContinue }: SelfHostedProps) {
- const { busy, setStatus } = useAuthContext()
- const [openingDocs, setOpeningDocs] = useState(false)
-
- const handleOpenDocs = async () => {
- if (openingDocs) return
- setOpeningDocs(true)
- try {
- // Vite can hot-reload renderer code while Electron still runs an older
- // preload script, matching the guard on the environment delete action.
- if (typeof window.clerum.auth.openDeploymentDocs !== 'function') {
- throw new Error('Restart the desktop app to finish loading the deployment guide link')
- }
- await window.clerum.auth.openDeploymentDocs()
- setStatus('Deployment guide opened in your browser.', 'success', undefined, {
- global: false,
- toast: true,
- })
- } catch (error) {
- setStatus(
- `The deployment guide could not be opened: ${
- error instanceof Error ? error.message : String(error)
- }`,
- 'error'
- )
- } finally {
- setOpeningDocs(false)
- }
- }
-
return (
- <>
- <h1>Run Evenfire yourself</h1>
- <p className="muted">
- Deploy Evenfire to a Kubernetes cluster you control — your own infrastructure or a local
- one. The deployment guide covers both, including what each shape needs.
- </p>
- <div className="auth-flow-card__actions">
- <Button block disabled={busy || openingDocs} onClick={() => void handleOpenDocs()}>
- Open the deployment guide
- </Button>
- <Button block disabled={busy} onClick={onContinue} variant="soft">
- I have a server — enter its address
- </Button>
- </div>
- </>
+ <LinkOutStep
+ title="Run Evenfire yourself"
+ body="Deploy Evenfire to a Kubernetes cluster you control — your own infrastructure or a local one. The deployment guide covers both, including what each shape needs."
+ channel="openDeploymentDocs"
+ linkLabel="Open the deployment guide"
+ successMessage="Deployment guide opened in your browser."
+ errorMessage="The deployment guide could not be opened"
+ continueLabel="I have a server — enter its address"
+ onContinue={onContinue}
+ />
)
}
diff --git a/desktop-app/ui/src/pages/OnboardingPage/types.ts b/desktop-app/ui/src/pages/OnboardingPage/types.ts
index 79c85de3a..1ce24a6f9 100644
--- a/desktop-app/ui/src/pages/OnboardingPage/types.ts
+++ b/desktop-app/ui/src/pages/OnboardingPage/types.ts
@@ -6,17 +6,12 @@
* action touches disk.
*/
-export type OnboardingStep = 'origin' | 'runStyle' | 'invited' | 'selfHosted' | 'manual'
+export type OnboardingStep = 'origin' | 'runStyle' | 'invited' | 'hosted' | 'selfHosted' | 'manual'
/** Q1 — "Do you already have an Evenfire server?" */
export type OnboardingOriginAnswer = 'invited' | 'haveAddress' | 'gettingStarted'
-/**
- * Q2 — "How do you want to run Evenfire?"
- *
- * Only reachable once the hosted trial path ships; until then Q1's
- * "just getting started" goes straight to the self-hosted step (spec §7.1).
- */
+/** Q2 — "How do you want to run Evenfire?" */
export type OnboardingRunStyleAnswer = 'hosted' | 'selfHosted'
export interface OnboardingViewModel {
diff --git a/desktop-app/ui/src/pages/__tests__/OnboardingPage.test.tsx b/desktop-app/ui/src/pages/__tests__/OnboardingPage.test.tsx
index a43d967aa..717e3cde6 100644
--- a/desktop-app/ui/src/pages/__tests__/OnboardingPage.test.tsx
+++ b/desktop-app/ui/src/pages/__tests__/OnboardingPage.test.tsx
@@ -14,12 +14,14 @@ afterEach(() => {
let probeLocalhostReachable = vi.fn()
let openDeploymentDocs = vi.fn()
+let openHostedSignup = vi.fn()
beforeEach(() => {
probeLocalhostReachable = vi.fn().mockResolvedValue(false)
openDeploymentDocs = vi.fn().mockResolvedValue({ opened: true })
+ openHostedSignup = vi.fn().mockResolvedValue({ opened: true })
;(window as unknown as { clerum: unknown }).clerum = {
- auth: { probeLocalhostReachable, openDeploymentDocs },
+ auth: { probeLocalhostReachable, openDeploymentDocs, openHostedSignup },
}
})
@@ -132,16 +134,47 @@ describe('OnboardingPage', () => {
expect(screen.getByLabelText('External REST API')).toBeTruthy()
})
- it('sends the getting-started answer to the self-hosted step while path A is unavailable', async () => {
+ it('sends the getting-started answer to Q2, leading with the hosted option', async () => {
const user = userEvent.setup()
renderOnboarding()
await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
- // Q2 is skipped entirely rather than offering a choice with one real answer.
- expect(screen.queryByText('How do you want to run Evenfire?')).toBeNull()
- expect(screen.getByText('Run Evenfire yourself')).toBeTruthy()
+ expect(screen.getByText('How do you want to run Evenfire?')).toBeTruthy()
+ const options = screen.getAllByRole('button', { name: /Evenfire hosts it|run it myself/ })
+ // Hosting is what someone just getting started should see first.
+ expect(options[0]?.textContent).toContain('Evenfire hosts it for me')
+ })
+
+ it('does not promise a trial the hosted service cannot deliver yet', async () => {
+ const user = userEvent.setup()
+
+ renderOnboarding()
+ await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+
+ const hosted = screen.getByRole('button', { name: /Evenfire hosts it for me/ })
+ expect(hosted.textContent).not.toMatch(/free|trial|week|\d+\s*day/i)
+ })
+
+ it('routes the hosted answer to a link-out step with a manual fallback', async () => {
+ const user = userEvent.setup()
+ const handleSaveRuntimeConfig = vi.fn()
+
+ renderOnboarding({ handleSaveRuntimeConfig })
+ await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+ await user.click(screen.getByRole('button', { name: /Evenfire hosts it for me/ }))
+
+ expect(screen.getByText('Evenfire hosts it for you')).toBeTruthy()
+
+ await user.click(screen.getByRole('button', { name: 'See hosted Evenfire' }))
+ expect(openHostedSignup).toHaveBeenCalledTimes(1)
+ // No argument: the renderer never names a URL for the main process (spec §6.8).
+ expect(openHostedSignup).toHaveBeenCalledWith()
+ expect(handleSaveRuntimeConfig).not.toHaveBeenCalled()
+
+ await user.click(screen.getByRole('button', { name: /I have a server — enter its address/ }))
+ expect(screen.getByLabelText('Environment name')).toBeTruthy()
})
it('keeps the self-hosted step neutral about where the server runs', async () => {
@@ -149,6 +182,7 @@ describe('OnboardingPage', () => {
renderOnboarding()
await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+ await user.click(screen.getByRole('button', { name: /I’ll run it myself/ }))
const step = screen.getByText('Run Evenfire yourself').closest('section')
const copy = step?.textContent || ''
@@ -163,6 +197,7 @@ describe('OnboardingPage', () => {
renderOnboarding({ handleSaveRuntimeConfig })
await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+ await user.click(screen.getByRole('button', { name: /I’ll run it myself/ }))
await user.click(screen.getByRole('button', { name: 'Open the deployment guide' }))
expect(openDeploymentDocs).toHaveBeenCalledTimes(1)
@@ -176,16 +211,18 @@ describe('OnboardingPage', () => {
renderOnboarding()
await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+ await user.click(screen.getByRole('button', { name: /I’ll run it myself/ }))
await user.click(screen.getByRole('button', { name: /I have a server — enter its address/ }))
expect(screen.getByLabelText('Environment name')).toBeTruthy()
})
- it('walks back to the previous step, and to Q1 from a two-step path', async () => {
+ it('walks back through every step of the longest path to Q1', async () => {
const user = userEvent.setup()
renderOnboarding()
await user.click(screen.getByRole('button', { name: /No, I’m just getting started/ }))
+ await user.click(screen.getByRole('button', { name: /I’ll run it myself/ }))
await user.click(screen.getByRole('button', { name: /I have a server — enter its address/ }))
expect(screen.getByLabelText('Environment name')).toBeTruthy()
@@ -193,6 +230,9 @@ describe('OnboardingPage', () => {
await user.click(screen.getByRole('button', { name: 'Back' }))
expect(screen.getByText('Run Evenfire yourself')).toBeTruthy()
+ await user.click(screen.getByRole('button', { name: 'Back' }))
+ expect(screen.getByText('How do you want to run Evenfire?')).toBeTruthy()
+
await user.click(screen.getByRole('button', { name: 'Back' }))
expect(screen.getByText('Do you already have an Evenfire server?')).toBeTruthy()
expect(screen.queryByRole('button', { name: 'Back' })).toBeNull()