Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
TypeScript antigravity-skillsbusiness-knowledgeclaude-codeclaude-skillscodebase-analysiscodexcodex-skillsdeveloper-tools-ai-agentgemini-cli-skillskarpathy-llm-wikiknowledge-baseknowledge-graphmemoryopencode-skillspi-agentunderstandcodevibe-coding
import { lazy, Suspense, useEffect, useState } from "react";
import type { GraphIssue } from "@understand-anything/core/schema";
import { useDashboardStore } from "../store";
import { useI18n } from "../contexts/I18nContext";
import GraphView from "./GraphView";
import DomainGraphView from "./DomainGraphView";
import KnowledgeGraphView from "./KnowledgeGraphView";
import SearchBar from "./SearchBar";
import NodeInfo from "./NodeInfo";
import ProjectOverview from "./ProjectOverview";
import FileExplorer from "./FileExplorer";
import WarningBanner from "./WarningBanner";
import StalenessBanner from "./StalenessBanner";
import type { DashboardFreshnessReport } from "../freshness";
import MobileBottomNav from "./MobileBottomNav";
import type { MobileTab } from "./MobileBottomNav";
import MobileDrawer from "./MobileDrawer";
const CodeViewer = lazy(() => import("./CodeViewer"));
const LearnPanel = lazy(() => import("./LearnPanel"));
const PathFinderModal = lazy(() => import("./PathFinderModal"));
const KeyboardShortcutsHelp = lazy(() => import("./KeyboardShortcutsHelp"));
interface Props {
accessToken: string;
showKeyboardHelp: boolean;
setShowKeyboardHelp: (value: boolean) => void;
loadError: string | null;
allIssues: GraphIssue[];
graphFreshness: DashboardFreshnessReport | null;
shortcuts: import("../hooks/useKeyboardShortcuts").KeyboardShortcut[];
}
export default function MobileLayout({
accessToken,
showKeyboardHelp,
setShowKeyboardHelp,
loadError,
allIssues,
graphFreshness,
shortcuts,
}: Props) {
const graph = useDashboardStore((s) => s.graph);
const selectedNodeId = useDashboardStore((s) => s.selectedNodeId);
const tourActive = useDashboardStore((s) => s.tourActive);
const persona = useDashboardStore((s) => s.persona);
const viewMode = useDashboardStore((s) => s.viewMode);
const domainGraph = useDashboardStore((s) => s.domainGraph);
const codeViewerOpen = useDashboardStore((s) => s.codeViewerOpen);
const closeCodeViewer = useDashboardStore((s) => s.closeCodeViewer);
const pathFinderOpen = useDashboardStore((s) => s.pathFinderOpen);
const togglePathFinder = useDashboardStore((s) => s.togglePathFinder);
const { t } = useI18n();
const [activeTab, setActiveTab] = useState<MobileTab>("graph");
const [drawerOpen, setDrawerOpen] = useState(false);
const [searchOpen, setSearchOpen] = useState(false);
// Auto-pivot to Info when a node is selected — keeps feedback visible
// on a small screen where graph and sidebar can't coexist
useEffect(() => {
if (selectedNodeId) setActiveTab("info");
}, [selectedNodeId]);
// When a code viewer opens (e.g. from the Files tab) keep focus there
useEffect(() => {
if (codeViewerOpen) setSearchOpen(false);
}, [codeViewerOpen]);
const isLearnMode = tourActive || persona === "junior";
const infoContent = (
<>
{selectedNodeId && <NodeInfo />}
{isLearnMode && (
<Suspense fallback={null}>
<LearnPanel />
</Suspense>
)}
{!selectedNodeId && !isLearnMode && <ProjectOverview />}
</>
);
return (
<div className="h-screen w-screen flex flex-col bg-root text-text-primary noise-overlay">
{/* Top bar */}
<header className="flex items-center gap-2 px-3 h-12 shrink-0 bg-surface border-b border-border-subtle">
<button
type="button"
onClick={() => setDrawerOpen(true)}
className="w-9 h-9 flex items-center justify-center rounded-lg text-text-secondary hover:text-text-primary hover:bg-elevated transition-colors -ml-1"
aria-label="Open menu"
>
<svg
className="w-5 h-5"
fill="none"
stroke="currentColor"
strokeWidth={1.8}
viewBox="0 0 24 24"
>
<path strokeLinecap="round" d="M4 7h16M4 12h16M4 17h16" />
</svg>
</button>
<h1 className="font-heading text-base flex-1 min-w-0 truncate text-center text-text-primary tracking-wide">
{graph?.project.name ?? t.common.appName}
</h1>
<button
type="button"
onClick={() => setSearchOpen((prev) => !prev)}
className={`w-9 h-9 flex items-center justify-center rounded-lg transition-colors -mr-1 ${
searchOpen
? "text-accent bg-accent/15"
: "text-text-secondary hover:text-text-primary hover:bg-elevated"
}`}
aria-label={searchOpen ? "Hide search" : "Show search"}
aria-pressed={searchOpen}
>
<svg
className="w-5 h-5"
fill="none"
stroke="currentColor"
strokeWidth={1.8}
viewBox="0 0 24 24"
>
<path
strokeLinecap="round"
strokeLinejoin="round"
d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"
/>
</svg>
</button>
</header>
{/* Search (collapsible) */}
{searchOpen && <SearchBar />}
{/* Graph freshness warning */}
{!loadError && <StalenessBanner freshness={graphFreshness} />}
{/* Validation warnings */}
{allIssues.length > 0 && !loadError && <WarningBanner issues={allIssues} />}
{/* Load error */}
{loadError && (
<div className="px-4 py-3 bg-red-900/30 border-b border-red-700 text-red-200 text-sm">
{loadError}
</div>
)}
{/* Tabbed content — all panes stay mounted to preserve layout/state.
Inactive panes are kept in the layout (not display:none) so that
ReactFlow keeps real dimensions and pinch/pan don't collapse on
tab switch. */}
<div className="flex-1 min-h-0 relative">
<div
className={`absolute inset-0 ${
activeTab === "graph" ? "" : "invisible pointer-events-none"
}`}
aria-hidden={activeTab !== "graph"}
>
{viewMode === "knowledge" ? (
<KnowledgeGraphView />
) : viewMode === "domain" && domainGraph ? (
<DomainGraphView />
) : (
<GraphView />
)}
</div>
<div
className={`absolute inset-0 overflow-auto bg-surface ${
activeTab === "info" ? "" : "invisible pointer-events-none"
}`}
aria-hidden={activeTab !== "info"}
>
{infoContent}
</div>
<div
className={`absolute inset-0 overflow-auto bg-surface ${
activeTab === "files" ? "" : "invisible pointer-events-none"
}`}
aria-hidden={activeTab !== "files"}
>
<FileExplorer />
</div>
</div>
{/* Bottom tab nav */}
<MobileBottomNav activeTab={activeTab} onTabChange={setActiveTab} />
{/* Drawer */}
<MobileDrawer
open={drawerOpen}
onClose={() => setDrawerOpen(false)}
onTogglePathFinder={togglePathFinder}
onShowKeyboardHelp={() => setShowKeyboardHelp(true)}
/>
{/* Code viewer — always fullscreen on mobile */}
{codeViewerOpen && (
<div
className="fixed inset-0 z-50 flex bg-black/70 backdrop-blur-sm p-2 sm:p-4"
onMouseDown={closeCodeViewer}
>
<div
className="flex-1 rounded-lg border border-border-medium bg-surface shadow-2xl overflow-hidden"
onMouseDown={(event) => event.stopPropagation()}
>
<Suspense fallback={null}>
<CodeViewer
accessToken={accessToken}
presentation="modal"
onClose={closeCodeViewer}
/>
</Suspense>
</div>
</div>
)}
{/* Keyboard help (mobile reads it as a quick reference too) */}
{showKeyboardHelp && (
<Suspense fallback={null}>
<KeyboardShortcutsHelp
shortcuts={shortcuts}
onClose={() => setShowKeyboardHelp(false)}
/>
</Suspense>
)}
{/* Path finder */}
{pathFinderOpen && (
<Suspense fallback={null}>
<PathFinderModal isOpen={pathFinderOpen} onClose={togglePathFinder} />
</Suspense>
)}
</div>
);
}