Function WelcomeSetup

desktop/src/features/workspaces/ui/WelcomeSetup.tsx:86–404

({
  defaultRelayUrl,
  initialTransitionMode = "initial",
  onComplete,
}: WelcomeSetupProps)

}

export function WelcomeSetup({
  defaultRelayUrl,
  initialTransitionMode = "initial",
  onComplete,
}: WelcomeSetupProps) {
  const [page, setPage] = React.useState<WelcomeSetupPage>("welcome");
  const [transitionMode, setTransitionMode] =
    React.useState<WelcomeTransitionMode>(initialTransitionMode);
  const [customWorkspaceName, setCustomWorkspaceName] = React.useState("");
  const [customRelayUrl, setCustomRelayUrl] = React.useState("");
  const [isConnecting, setIsConnecting] = React.useState(false);
  const [error, setError] = React.useState<string | null>(null);
  const systemColorScheme = useSystemColorScheme();

  const handleConnect = React.useCallback(
    async (relayUrl: string, workspaceName?: string, pubkey?: string) => {
      const trimmedUrl = relayUrl.trim();
      if (!trimmedUrl) {
        setError("Please enter a workspace URL.");
        return;
      }
      if (!workspaceName && isLocalDevRelayUrl(trimmedUrl)) {
        setError("Enter your relay URL to join a workspace.");
        setTransitionMode("forward");
        setPage("create-workspace");
        return;
      }

      const handoffStartedAt = performance.now();
      flushSync(() => {
        setIsConnecting(true);
        setError(null);
      });

      try {
        // We snapshot only the pubkey for display purposes (workspace switcher
        // labels, etc.). The private key lives on disk in `identity.key` and
        // is the single source of truth — never copied into localStorage.
        const identityPubkey = pubkey ?? (await getIdentity()).pubkey;
        const workspace = initFirstWorkspace(
          trimmedUrl,
          identityPubkey,
          workspaceName,
        );

        if (!workspaceName) {
          const elapsedMs = performance.now() - handoffStartedAt;
          if (elapsedMs < DEFAULT_WORKSPACE_HANDOFF_MIN_MS) {
            await wait(DEFAULT_WORKSPACE_HANDOFF_MIN_MS - elapsedMs);
          }
        }

        // The parent moves this workspace into React state so first-run setup
        // can continue without a full page reload.
        onComplete(workspace);
      } catch (err) {
        setError(
          err instanceof Error ? err.message : "Failed to connect. Try again.",