diff --git a/app/docs/collaboration/page.mdx b/app/docs/collaboration/page.mdx
new file mode 100644
index 0000000..8472880
--- /dev/null
+++ b/app/docs/collaboration/page.mdx
@@ -0,0 +1,25 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { FeatureList } from "@/components/docs/feature-list";
+import { SectionHeading } from "@/components/docs/section-heading";
+import { collaborationFeatures } from "@/lib/docs-content";
+
+export const metadata = {
+ title: "Collaboration | NodeBooks Documentation",
+ description: "See how NodeBooks keeps teams aligned with presence, shared runtimes, and live feedback.",
+};
+
+# Collaboration
+
+NodeBooks keeps everyone in the loop while experiments unfold. Real-time presence indicators, shared output streams, and session sharing remove the friction of pairing on notebooks remotely.
+
+Presence-aware editing
+
+Know who is editing a notebook and where their cursor is in real time. Inline comments and suggestions make asynchronous reviews feel collaborative.
+
+Shared execution output
+
+Notebook runs stream output to every participant, so you never wonder if a cell finished or failed. Broadcast a session during reviews or pair programming without screen sharing.
+
+
+
+
diff --git a/app/docs/getting-started/page.mdx b/app/docs/getting-started/page.mdx
new file mode 100644
index 0000000..75cfb7d
--- /dev/null
+++ b/app/docs/getting-started/page.mdx
@@ -0,0 +1,51 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { SectionHeading } from "@/components/docs/section-heading";
+import { workflow } from "@/lib/content";
+
+export const metadata = {
+ title: "Getting Started | NodeBooks Documentation",
+ description: "Install the NodeBooks CLI and create your first collaborative notebook workspace.",
+};
+
+# Getting Started
+
+NodeBooks is distributed as a CLI so you can set up workspaces from any terminal. Follow these steps to install the tooling, initialize a project, and open the desktop or web client.
+
+Install the CLI
+
+Install the CLI globally so the `nodebooks` command is always available. The installer handles downloading the latest runtime, linking the binary, and checking for required system dependencies.
+
+```
+npm install -g nodebooks
+```
+
+Create a workspace
+
+Run the interactive init command to scaffold a new space. The CLI prompts for a project name, notebook template, and optional GitHub connection so you can version your notebooks from day one.
+
+
+
+
+
Step
+
Description
+
Command
+
+
+
+ {workflow.map((step) => (
+
+
{step.title}
+
{step.description}
+
+ {step.code}
+
+
+ ))}
+
+
+
+Connect the clients
+
+Once the workspace is ready, open it in the web or desktop client. Both connect to the same runtime so teams can swap devices without losing context. Future docs will cover authentication flows and workspace governance in more depth.
+
+
diff --git a/app/docs/layout.tsx b/app/docs/layout.tsx
new file mode 100644
index 0000000..542c531
--- /dev/null
+++ b/app/docs/layout.tsx
@@ -0,0 +1,44 @@
+import Link from "next/link";
+import type { ReactNode } from "react";
+
+import { docsPages } from "@/lib/docs-navigation";
+
+import { SiteFooter } from "@/components/site-footer";
+import { ThemeToggle } from "@/components/theme-toggle";
+import { DocsSidebar } from "@/components/docs/sidebar";
+
+export default function DocsLayout({ children }: { children: ReactNode }) {
+ return (
+
+
+
+
+ NodeBooks
+
+
+
+ Product
+
+
+ Screenshots
+
+
+
+
+
+
+
+ {children}
+
+
+
+ );
+}
diff --git a/app/docs/notebook-authoring/page.mdx b/app/docs/notebook-authoring/page.mdx
new file mode 100644
index 0000000..7b2c3ca
--- /dev/null
+++ b/app/docs/notebook-authoring/page.mdx
@@ -0,0 +1,25 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { FeatureList } from "@/components/docs/feature-list";
+import { SectionHeading } from "@/components/docs/section-heading";
+import { notebookAuthoringFeatures } from "@/lib/docs-content";
+
+export const metadata = {
+ title: "Notebook Authoring | NodeBooks Documentation",
+ description: "Compose Markdown, TypeScript, and interactive components in a single notebook surface.",
+};
+
+# Notebook Authoring
+
+NodeBooks blends Markdown, runnable TypeScript, and reusable UI components so you can tell a complete story inside a single notebook. The authoring surface encourages experimentation without sacrificing polish.
+
+Markdown and code live together
+
+Draft ideas in Markdown cells, then drop into TypeScript when you need dynamic behavior. AI-assisted suggestions accelerate repetitive coding tasks so you can focus on the narrative.
+
+Rich components and visualizations
+
+Use built-in charting, diagramming, and UI components to make findings stand out. Render interactive elements inline, prototype dashboards, or embed bespoke React components sourced from your design system.
+
+
+
+
diff --git a/app/docs/page.mdx b/app/docs/page.mdx
new file mode 100644
index 0000000..629520d
--- /dev/null
+++ b/app/docs/page.mdx
@@ -0,0 +1,27 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { SectionHeading } from "@/components/docs/section-heading";
+
+export const metadata = {
+ title: "NodeBooks Documentation",
+ description: "Guides for building, collaborating, and shipping interactive Node.js notebooks.",
+};
+
+# NodeBooks Documentation
+
+NodeBooks combines a friendly notebook surface with the power of Node.js so you can explore ideas, collaborate, and publish in a single tool. These docs outline the product pillars today and leave room for deeper guides as the platform evolves.
+
+How to use these docs
+
+Use the sidebar to jump between key workflows. Each guide explains the why behind the feature set, highlights the current capabilities, and calls out the next pieces to document as the platform grows.
+
+- [Getting Started](/docs/getting-started) walks through installing the CLI and initializing a workspace.
+- [Notebook Authoring](/docs/notebook-authoring) focuses on writing Markdown, TypeScript, and visual outputs together.
+- [Runtime & Dependencies](/docs/runtime-and-dependencies) covers the sandboxed execution model and dependency management.
+- [Collaboration](/docs/collaboration) shows how real-time presence keeps teams in sync.
+- [Publishing & Sharing](/docs/publishing) explains how to ship notebooks as public-facing sites.
+
+What comes next
+
+Future iterations of the documentation will dive into workspace governance, deployment pipelines, and custom component authoring. As new features ship, expand each section with tutorials, API references, and troubleshooting guides.
+
+
diff --git a/app/docs/publishing/page.mdx b/app/docs/publishing/page.mdx
new file mode 100644
index 0000000..c16f282
--- /dev/null
+++ b/app/docs/publishing/page.mdx
@@ -0,0 +1,25 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { FeatureList } from "@/components/docs/feature-list";
+import { SectionHeading } from "@/components/docs/section-heading";
+import { publishingFeatures } from "@/lib/docs-content";
+
+export const metadata = {
+ title: "Publishing & Sharing | NodeBooks Documentation",
+ description: "Publish notebooks as production-ready sites and share results securely.",
+};
+
+# Publishing & Sharing
+
+Turn exploratory notebooks into polished deliverables without leaving the platform. NodeBooks handles build orchestration so you can focus on storytelling and distribution.
+
+Ship notebook sites
+
+Publish notebooks directly to the web with a few clicks. Preview deployments in private spaces, collect feedback, and push live when the content is ready.
+
+Iterate with your team
+
+Keep iterating on notebooks after they launch. Versioned deployments and workspace access controls let you refine docs, demos, and educational material safely.
+
+
+
+
diff --git a/app/docs/runtime-and-dependencies/page.mdx b/app/docs/runtime-and-dependencies/page.mdx
new file mode 100644
index 0000000..f95988d
--- /dev/null
+++ b/app/docs/runtime-and-dependencies/page.mdx
@@ -0,0 +1,25 @@
+import { DocsPager } from "@/components/docs/docs-pager";
+import { FeatureList } from "@/components/docs/feature-list";
+import { SectionHeading } from "@/components/docs/section-heading";
+import { runtimeAndDependencyFeatures } from "@/lib/docs-content";
+
+export const metadata = {
+ title: "Runtime & Dependencies | NodeBooks Documentation",
+ description: "Understand the sandboxed Node.js runtime and how to manage notebook-level dependencies.",
+};
+
+# Runtime & Dependencies
+
+Every notebook executes inside an isolated Node.js sandbox tuned for TypeScript. This keeps experiments reproducible while still letting you install the packages and tools you rely on.
+
+Sandboxed Node.js runtime
+
+Each notebook runs on demand with scoped environment variables, ensuring secrets never leak between projects. Streaming output keeps you informed about long-running tasks without leaving the page.
+
+Manage dependencies per notebook
+
+Install npm packages directly from a notebook cell or pin them in `package.json` for the entire workspace. NodeBooks keeps dependency state isolated so collaborators can explore without affecting production projects.
+
+
+
+
diff --git a/components/docs/docs-pager.tsx b/components/docs/docs-pager.tsx
new file mode 100644
index 0000000..4b643a7
--- /dev/null
+++ b/components/docs/docs-pager.tsx
@@ -0,0 +1,84 @@
+import Link from "next/link";
+
+import { ArrowLeft, ArrowRight } from "lucide-react";
+
+import type { DocsPageSlug } from "@/lib/docs-navigation";
+import { getAdjacentDocs } from "@/lib/docs-navigation";
+import { cn } from "@/lib/utils";
+
+interface DocsPagerProps {
+ slug: DocsPageSlug;
+}
+
+export function DocsPager({ slug }: DocsPagerProps) {
+ const { previous, next } = getAdjacentDocs(slug);
+
+ if (!previous && !next) {
+ return null;
+ }
+
+ return (
+