Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

3.9 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { atom, useAtomValue } from "jotai";
import { ArrowLeftIcon } from "lucide-react";
import { useEffect } from "react";
import { KernelStartupErrorModal } from "@/components/editor/KernelStartupErrorModal";
import { AppContainer } from "@/components/editor/app-container";
import { AppHeader } from "@/components/editor/header/app-header";
import { ProgressiveBoundary } from "@/components/lifecycle/ProgressiveBoundary";
import { Spinner } from "@/components/icons/spinner";
import { buttonVariants } from "@/components/ui/button";
import { cn } from "@/utils/cn";
import { CellsRenderer } from "../components/editor/renderers/cells-renderer";
import { hasCellsAtom, notebookIsRunningAtom } from "./cells/cells";
import type { AppConfig } from "./config/config-schema";
import { DocumentProvider } from "./notebook/document";
import { RuntimeState } from "./kernel/RuntimeState";
import { getSessionId } from "./kernel/session";
import { connectionAtom } from "./network/connection";
import { useRequestClient } from "./network/requests";
import { isAppConnecting } from "./session/connection-utils";
import { useNotebookSession } from "./session/useNotebookSession";

interface AppProps {
  appConfig: AppConfig;
  hideHeader?: boolean;
}

/**
 * Paint the (possibly empty) app once we have cells, or as soon as we are no
 * longer actively connecting. Without the connection check, a connected or
 * disconnected notebook with no cells would sit on a misleading "Connecting…"
 * spinner instead of rendering the empty app.
 */
const canPaintRunAppAtom = atom(
  (get) => get(hasCellsAtom) || !isAppConnecting(get(connectionAtom).state),
);

export const RunApp: React.FC<AppProps> = ({ appConfig, hideHeader }) => {
  const { sendComponentValues } = useRequestClient();

  // Initialize RuntimeState event-listeners
  useEffect(() => {
    RuntimeState.INSTANCE.start(sendComponentValues);
    return () => {
      RuntimeState.INSTANCE.stop();
    };
  }, [sendComponentValues]);

  const { connection, reconnect, documentModel } = useNotebookSession({
    autoInstantiate: true,
    sessionId: getSessionId(),
  });

  const isRunning = useAtomValue(notebookIsRunningAtom);

  const galleryHref = (() => {
    if (typeof window === "undefined") {
      return null;
    }
    const url = new URL(window.location.href);
    if (!url.searchParams.has("file")) {
      return null;
    }
    url.searchParams.delete("file");
    const search = url.searchParams.toString();
    return search ? `${url.pathname}?${search}` : url.pathname;
  })();

  return (
    <DocumentProvider model={documentModel}>
      <AppContainer
        connection={connection}
        isRunning={isRunning}
        width={appConfig.width}
        onReconnect={reconnect}
      >
        <KernelStartupErrorModal />
        <AppHeader
          connection={connection}
          className={hideHeader ? "hidden" : "sm:pt-8"}
        >
          {galleryHref && (
            <div className="flex items-center px-6 pt-4 sm:-mt-8">
              <a
                href={galleryHref}
                aria-label="Back to gallery"
                className={cn(
                  buttonVariants({ variant: "text", size: "sm" }),
                  "gap-2 px-0 text-muted-foreground hover:text-foreground",
                )}
              >
                <ArrowLeftIcon className="size-4" aria-hidden={true} />
                <span>Back</span>
              </a>
            </div>
          )}
        </AppHeader>
        <ProgressiveBoundary
          requires={canPaintRunAppAtom}
          delay={2000}
          fallback={
            <>
              <Spinner className="mx-auto" />
              <p className="text-center text-sm text-muted-foreground mt-2">
                Connecting...
              </p>
            </>
          }
        >
          <CellsRenderer appConfig={appConfig} mode="read" />
        </ProgressiveBoundary>
      </AppContainer>
    </DocumentProvider>
  );
};