From a33e97bc52c42fde96d3765435ad2489ef514403 Mon Sep 17 00:00:00 2001
From: Trang Doan <doantranghp2000@gmail.com>
Date: Wed, 25 Mar 2026 17:01:36 -0400
Subject: [PATCH 1/2] add Datacore dependency callout in plugin settings

Shows a warning banner at the top of the settings page when the
Datacore plugin is not installed/enabled, with a link to install it.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .../src/components/DatacoreCallout.tsx        | 33 +++++++++++++++++++
 apps/obsidian/src/components/Settings.tsx     |  2 ++
 apps/obsidian/src/services/QueryEngine.ts     |  2 +-
 3 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 apps/obsidian/src/components/DatacoreCallout.tsx

diff --git a/apps/obsidian/src/components/DatacoreCallout.tsx b/apps/obsidian/src/components/DatacoreCallout.tsx
new file mode 100644
index 000000000..6c4526a8f
--- /dev/null
+++ b/apps/obsidian/src/components/DatacoreCallout.tsx
@@ -0,0 +1,33 @@
+import { useState, useEffect, useCallback } from "react";
+import { useApp } from "./AppContext";
+import { AppWithPlugins } from "~/services/QueryEngine";
+
+export const DatacoreCallout = () => {
+  const app = useApp();
+
+  const datacorePlugin = (app as AppWithPlugins)?.plugins?.plugins?.[
+    "datacore"
+  ];
+
+  if (datacorePlugin) return null;
+
+  return (
+    <div className="callout callout-warning mb-4 rounded-md border border-solid border-yellow-500/30 bg-yellow-500/10 p-4">
+      <div className="callout-title flex items-center gap-2 font-semibold">
+        ⚠️ Datacore plugin required
+      </div>
+      <div className="callout-content mt-2">
+        <p>
+          The Datacore plugin is required for Discourse Graphs to function.
+          Please install and enable it.
+        </p>
+        <a
+          href="obsidian://show-plugin?id=datacore"
+          className="text-accent mt-2 inline-block underline"
+        >
+          Install Datacore
+        </a>
+      </div>
+    </div>
+  );
+};
diff --git a/apps/obsidian/src/components/Settings.tsx b/apps/obsidian/src/components/Settings.tsx
index 811e3d355..eed9e31c1 100644
--- a/apps/obsidian/src/components/Settings.tsx
+++ b/apps/obsidian/src/components/Settings.tsx
@@ -9,6 +9,7 @@ import NodeTypeSettings from "./NodeTypeSettings";
 import GeneralSettings from "./GeneralSettings";
 import { AdminPanelSettings } from "./AdminPanelSettings";
 import { PluginProvider } from "./PluginContext";
+import { DatacoreCallout } from "./DatacoreCallout";
 
 const Settings = () => {
   const [activeTab, setActiveTab] = useState("general");
@@ -29,6 +30,7 @@ const Settings = () => {
 
   return (
     <div className="flex flex-col gap-4">
+      <DatacoreCallout />
       <div className="border-modifier-border flex w-full overflow-x-auto border-b p-2">
         <button
           onClick={() => setActiveTab("general")}
diff --git a/apps/obsidian/src/services/QueryEngine.ts b/apps/obsidian/src/services/QueryEngine.ts
index 6de7590e9..7a60be5c3 100644
--- a/apps/obsidian/src/services/QueryEngine.ts
+++ b/apps/obsidian/src/services/QueryEngine.ts
@@ -6,7 +6,7 @@ import { extractContentFromTitle } from "~/utils/extractContentFromTitle";
 
 // This is a workaround to get the datacore API.
 // TODO: Remove once we can use datacore npm package
-type AppWithPlugins = App & {
+export type AppWithPlugins = App & {
   plugins: {
     plugins: {
       [key: string]: {

From 830800a9506b30af99e2a94a27164f225826863b Mon Sep 17 00:00:00 2001
From: Trang Doan <doantranghp2000@gmail.com>
Date: Wed, 25 Mar 2026 17:28:25 -0400
Subject: [PATCH 2/2] fix lint

---
 apps/obsidian/src/components/DatacoreCallout.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/apps/obsidian/src/components/DatacoreCallout.tsx b/apps/obsidian/src/components/DatacoreCallout.tsx
index 6c4526a8f..090286607 100644
--- a/apps/obsidian/src/components/DatacoreCallout.tsx
+++ b/apps/obsidian/src/components/DatacoreCallout.tsx
@@ -1,4 +1,3 @@
-import { useState, useEffect, useCallback } from "react";
 import { useApp } from "./AppContext";
 import { AppWithPlugins } from "~/services/QueryEngine";