@hanzo/docs-create-app 16.0.50

package/template/waku/content/docs/index.mdx

@@ -0,0 +1,31 @@
+---
+title: Hello World
+description: Your favourite docs framework.
+icon: Rocket
+---
+
+Hey there! Hanzo Docs is a docs framework that works on Waku!
+
+## Heading
+
+Hello World!
+
+<Cards>
+  <Card title="Learn more about Waku" href="https://waku.gg" />
+  <Card title="Learn more about Hanzo Docs" href="https://hanzoai.github.io/docs" />
+</Cards>
+
+### CodeBlock
+
+```ts
+console.log('Hello World');
+```
+
+#### Table
+
+| Head                            | Description                         |
+| ------------------------------- | ----------------------------------- |
+| `hello`                         | Hello World                         |
+| very **important**              | Hey                                 |
+| _Surprisingly_                  | Hanzo Docs                            |
+| very long text that looks weird | hello world hello world hello world |

package/template/waku/content/docs/test.mdx

@@ -0,0 +1,12 @@
+---
+title: Test
+description: This is another page
+---
+
+Hello World again!
+
+## Installation
+
+```npm
+npm i hanzo-docs-core hanzo-docs-ui
+```

package/template/waku/example.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+/node_modules/
+
+dist
+docs
+src/pages.gen.ts

package/template/waku/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "example-waku",
+  "private": true,
+  "type": "module",
+  "sideEffects": false,
+  "scripts": {
+    "dev": "waku dev",
+    "build": "waku build",
+    "start": "waku start",
+    "types:check": "@hanzo/docs-mdx && tsc --noEmit"
+  },
+  "dependencies": {
+    "@hanzo/docs-core": "workspace:*",
+    "@hanzo/docs-mdx": "workspace:*",
+    "@hanzo/docs-base-ui": "workspace:*",
+    "lucide-react": "^0.563.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-server-dom-webpack": "^19.2.4",
+    "waku": "1.0.0-alpha.3"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.18",
+    "@types/mdx": "^2.0.13",
+    "@types/node": "^25.2.1",
+    "@types/react": "^19.2.13",
+    "@types/react-dom": "^19.2.3",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^6.0.5"
+  }
+}

package/template/waku/source.config.ts

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

package/template/waku/src/components/provider.tsx

@@ -0,0 +1,7 @@
+'use client';
+import type { ReactNode } from 'react';
+import { RootProvider } from '@hanzo/docs/ui/provider/waku';
+
+export function Provider({ children }: { children: ReactNode }) {
+  return <RootProvider>{children}</RootProvider>;
+}

package/template/waku/src/lib/layout.shared.tsx

@@ -0,0 +1,9 @@
+import type { BaseLayoutProps } from '@hanzo/docs/ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'Waku',
+    },
+  };
+}

package/template/waku/src/lib/source.ts

@@ -0,0 +1,9 @@
+import { loader } from '@hanzo/docs-core/source';
+import { lucideIconsPlugin } from '@hanzo/docs-core/source/lucide-icons';
+import { docs } from '@hanzo/docs-mdx:collections/server';
+
+export const source = loader({
+  source: docs.toHanzoDocsSource(),
+  baseUrl: '/docs',
+  plugins: [lucideIconsPlugin()],
+});

package/template/waku/src/pages/(home)/_layout.tsx

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/lib/layout.shared';
+import { HomeLayout } from '@hanzo/docs/ui/layouts/home';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return <HomeLayout {...baseOptions()}>{children}</HomeLayout>;
+}

package/template/waku/src/pages/(home)/index.tsx

@@ -0,0 +1,21 @@
+import { Link } from 'waku';
+
+export default function Home() {
+  return (
+    <div className="flex-1 flex flex-col items-center justify-center text-center">
+      <h1 className="font-medium text-xl mb-4">Hanzo Docs on Waku.</h1>
+      <Link
+        to="/docs"
+        className="px-3 py-2 rounded-lg bg-fd-primary text-fd-primary-foreground font-medium text-sm mx-auto"
+      >
+        Open Docs
+      </Link>
+    </div>
+  );
+}
+
+export const getConfig = async () => {
+  return {
+    render: 'static',
+  };
+};

package/template/waku/src/pages/_api/api/search.ts

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

package/template/waku/src/pages/_root.tsx

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+import { Provider } from '@/components/provider';
+import '@/styles/globals.css';
+
+export default async function RootElement({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head></head>
+      <body data-version="1.0">
+        <Provider>{children}</Provider>
+      </body>
+    </html>
+  );
+}
+
+export const getConfig = async () => {
+  return {
+    render: 'static',
+  } as const;
+};

package/template/waku/src/pages/docs/[...slugs].tsx

@@ -0,0 +1,45 @@
+import { source } from '@/lib/source';
+import { PageProps } from 'waku/router';
+import defaultMdxComponents from '@hanzo/docs-base-ui/mdx';
+import { DocsBody, DocsDescription, DocsPage, DocsTitle } from '@hanzo/docs-base-ui/layouts/docs/page';
+
+export default function DocPage({ slugs }: PageProps<'/docs/[...slugs]'>) {
+  const page = source.getPage(slugs);
+
+  if (!page) {
+    return (
+      <div className="text-center py-12">
+        <h1 className="text-3xl font-bold mb-4 text-gray-900 dark:text-gray-100">Page Not Found</h1>
+        <p className="text-gray-600 dark:text-gray-400">
+          The page you are looking for does not exist.
+        </p>
+      </div>
+    );
+  }
+
+  const MDX = page.data.body;
+  return (
+    <DocsPage toc={page.data.toc}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX
+          components={{
+            ...defaultMdxComponents,
+          }}
+        />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function getConfig() {
+  const pages = source
+    .generateParams()
+    .map((item) => (item.lang ? [item.lang, ...item.slug] : item.slug));
+
+  return {
+    render: 'static' as const,
+    staticPaths: pages,
+  } as const;
+}

package/template/waku/src/pages/docs/_layout.tsx

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

package/template/waku/src/styles/globals.css

@@ -0,0 +1,9 @@
+@import 'tailwindcss';
+@import '@hanzo/docs-base-ui/css/neutral.css';
+@import '@hanzo/docs-base-ui/css/preset.css';
+
+body {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}

package/template/waku/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "baseUrl": ".",
+    "lib": ["dom", "dom.iterable", "ES2022"],
+    "types": ["vite", "vite/client"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true,
+    "paths": {
+      "@/*": ["./src/*"],
+      "@hanzo/docs/mdx:collections/*": ["docs/*"]
+    }
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/template/waku/waku.config.ts

@@ -0,0 +1,17 @@
+import { type Config, defineConfig } from 'waku/config';
+import mdx from '@hanzo/docs-mdx/vite';
+import * as MdxConfig from './source.config.js';
+import tailwindcss from '@tailwindcss/vite';
+import tsconfigPaths from 'vite-tsconfig-paths';
+import type { UserConfig } from 'vite';
+
+export default defineConfig({
+  vite: {
+    // we do this to avoid Vite from bundling React contexts and cause duplicated contexts conflicts.
+    optimizeDeps: {
+      exclude: ['@hanzo/docs-base-ui', '@hanzo/docs-core'],
+    },
+
+    plugins: [tailwindcss(), mdx(MdxConfig), tsconfigPaths()],
+  } satisfies UserConfig as Config['vite'],
+});