feat: Added FumaDocs

surfsense_web/.source/index.ts

@@ -0,0 +1,5 @@
+// @ts-nocheck -- skip type checking
+import * as docs_0 from "../content/docs/index.mdx?collection=docs&hash=1745310068376"
+import { _runtime } from "fumadocs-mdx"
+import * as _source from "../source.config"
+export const docs = _runtime.docs<typeof _source.docs>([{ info: {"path":"index.mdx","absolutePath":"C:/Users/91882/Documents/SurfSense/surfsense_web/content/docs/index.mdx"}, data: docs_0 }], [])

surfsense_web/.source/source.config.mjs

@@ -0,0 +1,8 @@
+// source.config.ts
+import { defineDocs } from "fumadocs-mdx/config";
+var docs = defineDocs({
+  dir: "content/docs"
+});
+export {
+  docs
+};

surfsense_web/app/api/search/route.ts

@@ -0,0 +1,4 @@
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+ 
+export const { GET } = createFromSource(source);

surfsense_web/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,46 @@
+import { source } from '@/lib/source';
+import {
+  DocsBody,
+  DocsDescription,
+  DocsPage,
+  DocsTitle,
+} from 'fumadocs-ui/page';
+import { notFound } from 'next/navigation';
+import { getMDXComponents } from '@/mdx-components';
+ 
+export default async function Page(props: {
+  params: Promise<{ slug?: string[] }>;
+}) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+ 
+  const MDX = page.data.body;
+ 
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX components={getMDXComponents()} />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+ 
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+ 
+export async function generateMetadata(props: {
+  params: Promise<{ slug?: string[] }>;
+}) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+ 
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}

surfsense_web/app/docs/layout.tsx

@@ -0,0 +1,12 @@
+import { source } from '@/lib/source';
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/app/layout.config';
+ 
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout tree={source.pageTree} {...baseOptions}>
+      {children}
+    </DocsLayout>
+  );
+}

surfsense_web/app/globals.css

@@ -1,4 +1,6 @@
-@import "tailwindcss";
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
 
 @plugin "tailwindcss-animate";
 

surfsense_web/app/layout.config.tsx

@@ -0,0 +1,7 @@
+import { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+ 
+export const baseOptions: BaseLayoutProps = {
+  nav: {
+    title: 'SurfSense Documentation',
+  },
+};

surfsense_web/app/layout.tsx

@@ -5,6 +5,7 @@ import { Roboto } from "next/font/google";
 
 import { Toaster } from "@/components/ui/sonner";
 import { ThemeProvider } from "@/components/theme/theme-provider";
+import { RootProvider } from 'fumadocs-ui/provider';
 
 const roboto = Roboto({ 
   subsets: ["latin"],
@@ -64,8 +65,10 @@ export default async function RootLayout({
           disableTransitionOnChange
           defaultTheme="light"
         >
-          {children}
+          <RootProvider>
-          <Toaster />
+            {children}
+            <Toaster />
+          </RootProvider>
         </ThemeProvider>
       </body>
     </html>

surfsense_web/content/docs/index.mdx

@@ -0,0 +1,7 @@
+---
+title: Welcome Docs
+---
+ 
+## Introduction
+ 
+I love Docs.

surfsense_web/lib/source.ts

@@ -0,0 +1,7 @@
+import { docs } from '@/.source';
+import { loader } from 'fumadocs-core/source';
+ 
+export const source = loader({
+  baseUrl: '/docs',
+  source: docs.toFumadocsSource(),
+});

surfsense_web/mdx-components.tsx

@@ -0,0 +1,9 @@
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+import type { MDXComponents } from 'mdx/types';
+ 
+export function getMDXComponents(components?: MDXComponents): MDXComponents {
+  return {
+    ...defaultMdxComponents,
+    ...components,
+  };
+}

surfsense_web/next.config.ts

@@ -1,4 +1,5 @@
 import type { NextConfig } from "next";
+import { createMDX } from 'fumadocs-mdx/next';
 
 const nextConfig: NextConfig = {
   typescript: {
@@ -9,4 +10,7 @@ const nextConfig: NextConfig = {
   },
 };
 
-export default nextConfig;
+// Wrap the config with createMDX
+const withMDX = createMDX({});
+
+export default withMDX(nextConfig);

surfsense_web/package.json

@@ -4,13 +4,15 @@
   "private": true,
   "description": "SurfSense Frontend",
   "scripts": {
-    "dev": "next dev --turbopack",
+    "dev": "next dev",
+    "dev:turbopack": "next dev --turbopack",
     "build": "next build",
     "start": "next start",
     "lint": "next lint",
     "debug": "cross-env NODE_OPTIONS=--inspect next dev --turbopack",
     "debug:browser": "cross-env NODE_OPTIONS=--inspect next dev --turbopack",
-    "debug:server": "cross-env NODE_OPTIONS=--inspect=0.0.0.0:9229 next dev --turbopack"
+    "debug:server": "cross-env NODE_OPTIONS=--inspect=0.0.0.0:9229 next dev --turbopack",
+    "postinstall": "fumadocs-mdx"
   },
   "dependencies": {
     "@ai-sdk/react": "^1.1.21",
@@ -31,12 +33,16 @@
     "@radix-ui/react-tooltip": "^1.1.8",
     "@tabler/icons-react": "^3.30.0",
     "@tanstack/react-table": "^8.21.2",
+    "@types/mdx": "^2.0.13",
     "ai": "^4.1.54",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
     "emblor": "^1.4.7",
     "framer-motion": "^12.4.7",
+    "fumadocs-core": "^15.2.9",
+    "fumadocs-mdx": "^11.6.1",
+    "fumadocs-ui": "^15.2.9",
     "geist": "^1.3.1",
     "lucide-react": "^0.477.0",
     "next": "15.2.3",

surfsense_web/source.config.ts

@@ -0,0 +1,5 @@
+import { defineDocs } from 'fumadocs-mdx/config';
+ 
+export const docs = defineDocs({
+  dir: 'content/docs',
+});

surfsense_web/tsconfig.json

@@ -22,6 +22,6 @@
       "@/*": ["./*"]
     }
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "next.config.mjs"],
   "exclude": ["node_modules"]
 }