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.

Fix duplicate HTML5 backend error in file explorer (#7723)

Trevor Manzc435814474a3
diff --git a/frontend/package.json b/frontend/package.json
index 9913148084..97776a4ead 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -118,6 +118,7 @@
"cssnano": "^7.1.2",
"date-fns": "^4.1.0",
"dequal": "^2.0.3",
+ "dnd-core": "^16.0.1",
"dompurify": "^3.3.1",
"eslint-plugin-header": "^3.1.1",
"htm": "^3.1.1",
@@ -144,6 +145,8 @@
"react-aria": "^3.44.0",
"react-aria-components": "^1.13.0",
"react-codemirror-merge": "4.25.4",
+ "react-dnd": "^16.0.1",
+ "react-dnd-html5-backend": "^16.0.1",
"react-dropzone": "^14.3.8",
"react-error-boundary": "^5.0.0",
"react-grid-layout": "^1.5.3",
diff --git a/frontend/src/components/editor/chrome/panels/file-explorer-panel.tsx b/frontend/src/components/editor/chrome/panels/file-explorer-panel.tsx
index 4802f0d29c..3625b68ab2 100644
--- a/frontend/src/components/editor/chrome/panels/file-explorer-panel.tsx
+++ b/frontend/src/components/editor/chrome/panels/file-explorer-panel.tsx
@@ -3,6 +3,7 @@
import React from "react";
import useResizeObserver from "use-resize-observer";
import { cn } from "@/utils/cn";
+import { TreeDndProvider } from "../../file-tree/dnd-wrapper";
import { FileExplorer } from "../../file-tree/file-explorer";
import { useFileExplorerUpload } from "../../file-tree/upload";
@@ -14,21 +15,23 @@ const FileExplorerPanel: React.FC = () => {
});
return (
- <div
- {...getRootProps()}
- className={cn("flex flex-col flex-1 overflow-hidden relative")}
- >
- <input {...getInputProps()} />
- {isDragActive && (
- <div className="absolute inset-0 flex items-center uppercase justify-center text-xl font-bold text-primary/90 bg-accent/85 z-10 border-2 border-dashed border-primary/90 rounded-lg pointer-events-none">
- Drop files here
- </div>
- )}
+ <TreeDndProvider>
+ <div
+ {...getRootProps()}
+ className={cn("flex flex-col flex-1 overflow-hidden relative")}
+ >
+ <input {...getInputProps()} />
+ {isDragActive && (
+ <div className="absolute inset-0 flex items-center uppercase justify-center text-xl font-bold text-primary/90 bg-accent/85 z-10 border-2 border-dashed border-primary/90 rounded-lg pointer-events-none">
+ Drop files here
+ </div>
+ )}
- <div ref={ref} className="flex flex-col flex-1 overflow-hidden">
- <FileExplorer height={height} />
+ <div ref={ref} className="flex flex-col flex-1 overflow-hidden">
+ <FileExplorer height={height} />
+ </div>
</div>
- </div>
+ </TreeDndProvider>
);
};
diff --git a/frontend/src/components/editor/file-tree/dnd-wrapper.tsx b/frontend/src/components/editor/file-tree/dnd-wrapper.tsx
new file mode 100644
index 0000000000..9251a4522e
--- /dev/null
+++ b/frontend/src/components/editor/file-tree/dnd-wrapper.tsx
@@ -0,0 +1,56 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import type { DragDropManager } from "dnd-core";
+import type React from "react";
+import { createContext, useContext, useState } from "react";
+import { DndProvider, useDragDropManager } from "react-dnd";
+import { HTML5Backend } from "react-dnd-html5-backend";
+
+const DndManagerContext = createContext<DragDropManager | null>(null);
+
+/**
+ * Hook to get the shared DragDropManager instance.
+ * Must be used within a TreeDndProvider.
+ */
+export function useTreeDndManager(): DragDropManager | undefined {
+ const manager = useContext(DndManagerContext);
+ return manager ?? undefined;
+}
+
+/**
+ * Inner component that extracts and provides the DragDropManager
+ */
+const DndManagerProvider: React.FC<{ children: React.ReactNode }> = ({
+ children,
+}) => {
+ const manager = useDragDropManager();
+ return (
+ <DndManagerContext.Provider value={manager}>
+ {children}
+ </DndManagerContext.Provider>
+ );
+};
+
+/**
+ * Wrapper component that provides a shared react-dnd HTML5Backend context.
+ * Use this to wrap areas that contain react-arborist Trees to prevent
+ * "Cannot have two HTML5 backends at the same time" errors.
+ *
+ * Pass the manager to Tree via: dndManager={useTreeDndManager()}
+ */
+export const TreeDndProvider: React.FC<{ children: React.ReactNode }> = ({
+ children,
+}) => {
+ // Use state to store the root element for scoping the backend
+ const [rootElement, setRootElement] = useState<HTMLDivElement | null>(null);
+
+ return (
+ <div ref={setRootElement} className="contents">
+ {rootElement && (
+ <DndProvider backend={HTML5Backend} options={{ rootElement }}>
+ <DndManagerProvider>{children}</DndManagerProvider>
+ </DndProvider>
+ )}
+ </div>
+ );
+};
diff --git a/frontend/src/components/editor/file-tree/file-explorer.tsx b/frontend/src/components/editor/file-tree/file-explorer.tsx
index 27cef087a2..c1d51d9ccf 100644
--- a/frontend/src/components/editor/file-tree/file-explorer.tsx
+++ b/frontend/src/components/editor/file-tree/file-explorer.tsx
@@ -60,6 +60,7 @@ import type { FilePath } from "@/utils/paths";
import { fileSplit } from "@/utils/pathUtils";
import { jotaiJsonStorage } from "@/utils/storage/jotai";
import marimoIcon from "../../../assets/icon-32x32.png";
+import { useTreeDndManager } from "./dnd-wrapper";
import { FileViewer } from "./file-viewer";
import type { RequestingTree } from "./requesting-tree";
import { openStateAtom, treeAtom } from "./state";
@@ -86,6 +87,7 @@ export const FileExplorer: React.FC<{
height: number;
}> = ({ height }) => {
const treeRef = useRef<TreeApi<FileInfo>>(null);
+ const dndManager = useTreeDndManager();
const [tree] = useAtom(treeAtom);
const [data, setData] = useState<FileInfo[]>([]);
const [openFile, setOpenFile] = useState<FileInfo | null>(null);
@@ -192,6 +194,8 @@ export const FileExplorer: React.FC<{
data={visibleData}
initialOpenState={openState}
openByDefault={false}
+ // Use shared DnD manager to prevent "Cannot have two HTML5 backends" error
+ dndManager={dndManager}
// Hide the drop cursor
renderCursor={() => null}
// Disable dropping files into files
diff --git a/frontend/vite.config.mts b/frontend/vite.config.mts
index 7bb8f85774..3fdeb52474 100644
--- a/frontend/vite.config.mts
+++ b/frontend/vite.config.mts
@@ -296,6 +296,10 @@ export default defineConfig({
"@emotion/cache",
"@codemirror/view",
"@codemirror/state",
+ // Dedupe react-dnd to prevent "Cannot have two HTML5 backends" errors
+ "react-dnd",
+ "react-dnd-html5-backend",
+ "dnd-core",
],
},
experimental: {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index ae2eefb042..ea1eeb4893 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -340,6 +340,9 @@ importers:
dequal:
specifier: ^2.0.3
version: 2.0.3
+ dnd-core:
+ specifier: ^16.0.1
+ version: 16.0.1
dompurify:
specifier: ^3.3.1
version: 3.3.1
@@ -418,6 +421,12 @@ importers:
react-codemirror-merge:
specifier: 4.25.4
+ react-dnd:
+ specifier: ^16.0.1
+ version: 16.0.1(@types/[email protected])(@types/[email protected])([email protected])
+ react-dnd-html5-backend:
+ specifier: ^16.0.1
+ version: 16.0.1
react-dropzone:
specifier: ^14.3.8
version: 14.3.8([email protected])
@@ -3002,12 +3011,21 @@ packages:
'@react-dnd/[email protected]':
resolution: {integrity: sha512-kLy0PJDDwvwwTXxqTFNAAllPHD73AycE9ypWeln/IguoGBEbvFcPDbCV03G52bEcC5E+YgupBE0VzHGdC8SIXg==}
+ '@react-dnd/[email protected]':
+ resolution: {integrity: sha512-WLyfoHvxhs0V9U+GTsGilGgf2QsPl6ZZ44fnv0/b8T3nQyvzxidxsg/ZltbWssbsRDlYW8UKSQMTGotuTotZ6A==}
+
'@react-dnd/[email protected]':
resolution: {integrity: sha512-xL4RCQBCBDJ+GRwKTFhGUW8GXa4yoDfJrPbLblc3U09ciS+9ZJXJ3Qrcs/x2IODOdIE5kQxvMmE2UKyqUictUw==}
+ '@react-dnd/[email protected]':
+ resolution: {integrity: sha512-xKCTqAK/FFauOM9Ta2pswIyT3D8AQlfrYdOi/toTPEhqCuAs1v5tcJ3Y08Izh1cJ5Jchwy9SeAXmMg6zrKs2iw==}
+
'@react-dnd/[email protected]':
resolution: {integrity: sha512-Pc/AFTdwZwEKJxFJvlxrSmGe/di+aAOBn60sremrpLo6VI/6cmiUYNNwlI5KNYttg7uypzA3ILPMPgxB2GYZEg==}
+ '@react-dnd/[email protected]':
+ resolution: {integrity: sha512-/RVXdLvJxLg4QKvMoM5WlwNR9ViO9z8B/qPcc+C0Sa/teJY7QG7kJ441DwzOjMYEY7GmU4dj5EcGHIkKZiQZCA==}
+
'@react-stately/[email protected]':
resolution: {integrity: sha512-YfP/TrvkOCp6j7oqpZxJSvmSeXn+XtbKSOiBOuo+m2zCIhW2ncThmDB9uAUOkpmikDv/LkGKni40RQE8USdGdA==}
peerDependencies:
@@ -5657,6 +5675,9 @@ packages:
resolution: {integrity: sha512-+PVS2VPTgKFPYWo3vAFEA8WPbTf7/xo43TifH9G8S1KqnrQu0o77A3unrF5yOugy4mIz7K5wAVFHUcha7wsz6A==}
+ resolution: {integrity: sha512-HK294sl7tbw6F6IeuK16YSBUoorvHpY8RHO+9yFfaJyCDVb6n7PRcezrOEOa2SBCqiYpemh5Jx20ZcjKdFAVng==}
+
resolution: {integrity: sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==}
engines: {node: '>=0.10.0'}
@@ -8408,6 +8429,9 @@ packages:
resolution: {integrity: sha512-6ONeqEC3XKVf4eVmMTe0oPds+c5B9Foyj8p/ZKLb7kL2qh9COYxiBHv3szd6gztqi/efkmriywLUVlPotqoJyw==}
+ resolution: {integrity: sha512-Wu3dw5aDJmOGw8WjH1I1/yTH+vlXEL4vmjk5p+MHxP8HuHJS1lAGeIdG/hze1AvNeXWo/JgULV87LyQOr+r5jw==}
+
resolution: {integrity: sha512-9i1jSgbyVw0ELlEVt/NkCUkxy1hmhJOkePoCH713u75vzHGyXhPDm28oLfc2NMSBjZRM1Y+wRjHXJT3sPrTy+A==}
peerDependencies:
@@ -8423,6 +8447,21 @@ packages:
'@types/react':
optional: true
+ resolution: {integrity: sha512-QeoM/i73HHu2XF9aKksIUuamHPDvRglEwdHL4jsp784BgUuWcg6mzfxT0QDdQz8Wj0qyRKx2eMg8iZtWvU4E2Q==}
+ peerDependencies:
+ '@types/hoist-non-react-statics': '>= 3.3.1'
+ '@types/node': '>= 12'
+ '@types/react': '>= 16'
+ react: ^19.2.3
+ peerDependenciesMeta:
+ '@types/hoist-non-react-statics':
+ optional: true
+ '@types/node':
+ optional: true
+ '@types/react':
+ optional: true
+
resolution: {integrity: sha512-ZtAp5XTO5HRzQctjPU0ybY0RRCQO19X/8fxn3w7y2VVTUbGHDKULPTL4ky3vB05euSgG5NpALhEhDPvQ56wvXg==}
peerDependencies:
@@ -13377,10 +13416,16 @@ snapshots:
'@react-dnd/[email protected]': {}
+ '@react-dnd/[email protected]': {}
+
'@react-dnd/[email protected]': {}
+ '@react-dnd/[email protected]': {}
+
'@react-dnd/[email protected]': {}
+ '@react-dnd/[email protected]': {}
+
dependencies:
'@react-stately/utils': 3.10.8([email protected])
@@ -16304,6 +16349,12 @@ snapshots:
'@react-dnd/invariant': 2.0.0
redux: 4.2.1
+ dependencies:
+ '@react-dnd/asap': 5.0.2
+ '@react-dnd/invariant': 4.0.2
+ redux: 4.2.1
+
dependencies:
esutils: 2.0.3
@@ -19737,6 +19788,10 @@ snapshots:
dependencies:
dnd-core: 14.0.1
+ dependencies:
+ dnd-core: 16.0.1
+
dependencies:
'@react-dnd/invariant': 2.0.0
@@ -19749,6 +19804,18 @@ snapshots:
'@types/node': 24.10.4
'@types/react': 19.2.7
+ dependencies:
+ '@react-dnd/invariant': 4.0.2
+ '@react-dnd/shallowequal': 4.0.2
+ dnd-core: 16.0.1
+ fast-deep-equal: 3.1.3
+ hoist-non-react-statics: 3.3.2
+ react: 19.2.3
+ optionalDependencies:
+ '@types/node': 24.10.4
+ '@types/react': 19.2.7
+
dependencies:
typescript: 5.9.3