databricks · pkosiec · Dec 19, 2025 · Dec 18, 2025 · Dec 19, 2025
diff --git a/docs/README.md b/docs/README.md
@@ -15,7 +15,7 @@ pnpm install
 ## Local Development
 
 ```bash
-pnpm start
+pnpm dev
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

diff --git a/docs/blog/2019-05-28-first-blog-post.md b/docs/blog/2019-05-28-first-blog-post.md
diff --git a/docs/blog/2019-05-29-long-blog-post.md b/docs/blog/2019-05-29-long-blog-post.md
diff --git a/docs/blog/2021-08-01-mdx-blog-post.mdx b/docs/blog/2021-08-01-mdx-blog-post.mdx
diff --git a/docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg b/docs/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg
diff --git a/docs/blog/2021-08-26-welcome/index.md b/docs/blog/2021-08-26-welcome/index.md
diff --git a/docs/blog/authors.yml b/docs/blog/authors.yml
diff --git a/docs/blog/tags.yml b/docs/blog/tags.yml
diff --git a/docs/docs/core-concepts/_category_.json b/docs/docs/core-concepts/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Core Concepts",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "description": "Learn about the fundamental concepts and principles behind AppKit."
+  }
+}
diff --git a/principles.md → docs/docs/core-concepts/principles.md b/principles.md → docs/docs/core-concepts/principles.md
@@ -1,23 +1,24 @@
-SDK Core Principles
-1. Highly Opinionated
-  The SDK must provide a clear path with best practices for building Databricks
+# Principles
+
+## 1. Highly Opinionated
+  AppKit must provide a clear path with best practices for building Databricks
   applications. We provide strong defaults, with advanced customization when needed.
-2. Built for Application Use Cases
+## 2. Built for Application Use Cases
   This SDK is for application development, not infrastructure management.
   Databricks' internal implementation details must be abstracted. We're building an
   application SDK, not a service wrapper.
-3. Delightful Developer Experience
+## 3. Delightful Developer Experience
   Every interface, doc, example, tool, and implementation must provide developer joy. Combined with the Highly Opinionated principle, this creates a true plug-and-play experience.
-4. Zero-Trust Security
+## 4. Zero-Trust Security
   Minimize exposed surface area, fail safely by default, and validate all inputs.
-  The SDK must always have a zero-trust mindset.
-5. Optimized for Humans and AI
+  AppKit must always have a zero-trust mindset.
+## 5. Optimized for Humans and AI
   Developers and LLMs both use this SDK. Every API must be discoverable,
   self-documenting, and inferable by both types of users. Test with both.
-6. Production-Ready from Day One
+## 6. Production-Ready from Day One
   Even the smallest feature can be used by enterprise users, so everything
   shipped must be production-ready. Observability, reliability, and scalability
   since day one.
-7. Layered Extensibility
-The SDK provides high-level plugins, low-level primitives, and extension points for custom plugins. It integrates into any application architecture and never blocks your path forward.
+## 7. Layered Extensibility
+AppKit provides high-level plugins, low-level primitives, and extension points for custom plugins. It integrates into any application architecture and never blocks your path forward.
 
diff --git a/docs/docs/index.md b/docs/docs/index.md
@@ -0,0 +1,13 @@
+---
+sidebar_position: 1
+---
+
+# Getting started
+
+## Introduction
+
+## Installation
+
+## Usage
+
+## Deployment
diff --git a/docs/docs/intro.md b/docs/docs/intro.md
diff --git a/docs/docs/tutorial-basics/_category_.json b/docs/docs/tutorial-basics/_category_.json
diff --git a/docs/docs/tutorial-basics/congratulations.md b/docs/docs/tutorial-basics/congratulations.md
diff --git a/docs/docs/tutorial-basics/create-a-blog-post.md b/docs/docs/tutorial-basics/create-a-blog-post.md