Merge pull request #2 from muppet-dev/feat/fuma

feat: added fuma docs

Author: MathurAditya724

docs/.gitignore

@@ -1,21 +1,28 @@
-# build output
-dist/
-# generated types
-.astro/
+# deps
+/node_modules
 
-# dependencies
-node_modules/
+# generated content
+.contentlayer
+.content-collections
+.source
 
-# logs
+# test & build
+/coverage
+/.next/
+/out/
+/build
+*.tsbuildinfo
+
+# misc
+.DS_Store
+*.pem
+/.pnp
+.pnp.js
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-pnpm-debug.log*
-
 
-# environment variables
-.env
-.env.production
-
-# macOS-specific files
-.DS_Store
+# others
+.env*.local
+.vercel
+next-env.d.ts

docs/.vscode/extensions.json

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

docs/.vscode/launch.json

@@ -0,0 +1,62 @@
+import { source } from "@/lib/source";
+import {
+  DocsPage,
+  DocsBody,
+  DocsDescription,
+  DocsTitle,
+} from "fumadocs-ui/page";
+import { notFound } from "next/navigation";
+import defaultMdxComponents, { createRelativeLink } from "fumadocs-ui/mdx";
+
+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 MDXContent = page.data.body;
+
+  return (
+    <DocsPage
+      toc={page.data.toc}
+      full={page.data.full}
+      editOnGithub={{
+        owner: "muppet-dev",
+        repo: "muppet",
+        sha: "main",
+        path: `/docs/content/docs/${page.file.path}`,
+      }}
+    >
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDXContent
+          components={{
+            ...defaultMdxComponents,
+            // this allows you to link to other pages with relative file paths
+            a: createRelativeLink(source, page),
+            // you can add other MDX components here
+          }}
+        />
+      </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,
+  };
+}

docs/app/api/search/route.ts

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

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

@@ -0,0 +1,5 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
+
+@source '../node_modules/fumadocs-ui/dist/**/*.js';

docs/app/docs/layout.tsx

@@ -0,0 +1,31 @@
+import { Logo } from "@/components/Logo";
+import { FaBluesky, FaXTwitter } from "react-icons/fa6";
+import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
+
+/**
+ * Shared layout configurations
+ *
+ * you can customise layouts individually from:
+ * Home Layout: app/(home)/layout.tsx
+ * Docs Layout: app/docs/layout.tsx
+ */
+export const baseOptions: BaseLayoutProps = {
+  nav: {
+    title: <Logo />,
+  },
+  links: [
+    {
+      type: "icon",
+      icon: <FaBluesky />,
+      text: "X",
+      url: "https://x.com/muppetdev",
+    },
+    {
+      type: "icon",
+      icon: <FaXTwitter />,
+      text: "BlueSky",
+      url: "https://bsky.app/profile/muppet.dev",
+    },
+  ],
+  githubUrl: "https://github.com/muppet-dev/muppet",
+};

docs/app/favicon.ico

@@ -0,0 +1,70 @@
+import "./global.css";
+import { RootProvider } from "fumadocs-ui/provider";
+import type { Metadata } from "next";
+import { Geist } from "next/font/google";
+import SeoBanner from "@/public/banner.png";
+import type { ReactNode } from "react";
+
+const inter = Geist({
+  subsets: ["latin"],
+});
+
+export function generateMetadata(): Metadata {
+  const title = {
+    template: "%s | muppet",
+    default: "muppet - Toolkit for building MCPs",
+  };
+  const description =
+    "Muppet is an open toolkit which standardizes the way you build, test, and deploy your MCPs. If MCP is the USB-C port for AI applications, think of Muppet as the assembly line that produces the USB-C port.";
+
+  return {
+    title,
+    description,
+    keywords: [
+      "MCP",
+      "MCPs",
+      "MCP toolkit",
+      "MCP development",
+      "Honojs",
+      "toolkit",
+      "javascript",
+      "typescript",
+      "hono",
+    ],
+    metadataBase: new URL("https://muppet.dev"),
+    category: "education",
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: {
+        width: SeoBanner.width,
+        height: SeoBanner.height,
+        url: SeoBanner.src,
+      },
+    },
+    openGraph: {
+      title,
+      description,
+      images: {
+        width: SeoBanner.width,
+        height: SeoBanner.height,
+        url: SeoBanner.src,
+      },
+      siteName: "Muppet Docs",
+      url: "/",
+      locale: "en_US",
+      type: "website",
+    },
+  };
+}
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en" className={inter.className} suppressHydrationWarning>
+      <body className="flex flex-col min-h-screen">
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  );
+}