chore: import upstream snapshot with attribution

docs/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+.next/
+next-env.d.ts
+.next-gate/
+.next-agent/
+.next-check/

docs/AGENTS.md

@@ -0,0 +1,22 @@
+# Docs Site Conventions
+
+## MDX Tables
+
+Always use HTML `<table>` syntax in MDX pages, never markdown pipe tables. This ensures consistent styling and avoids MDX parsing edge cases.
+
+```html
+<table>
+  <thead>
+    <tr>
+      <th>Column</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>field</code></td>
+      <td>What it does</td>
+    </tr>
+  </tbody>
+</table>
+```

docs/next.config.mjs

@@ -0,0 +1,40 @@
+import createMDX from "@next/mdx";
+import { createRequire } from "node:module";
+
+// Resolve the plugin to an absolute path (still a string, so the config
+// stays serializable for Turbopack). A bare "remark-gfm" is require()d
+// from the MDX loader's own package context, which under pnpm's strict
+// module isolation cannot see this app's dependencies — production
+// builds resolved it, the Turbopack dev server did not.
+const require = createRequire(import.meta.url);
+
+const withMDX = createMDX({
+  options: {
+    // GFM is what gives .mdx pages pipe tables (plus autolinks and
+    // strikethrough) — without it, table markdown renders as a plain
+    // paragraph of pipes.
+    remarkPlugins: [[require.resolve("remark-gfm")]],
+  },
+});
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  pageExtensions: ["ts", "tsx", "md", "mdx"],
+  // CI-style builds set NEXT_DIST_DIR so `pnpm check` never shares .next
+  // with a running dev server (a shared dist dir corrupts the dev cache).
+  distDir: process.env.NEXT_DIST_DIR || ".next",
+  // The gate builds into .next-gate INSIDE this dir; without an ignore,
+  // the dev watcher sees every one of those build files land and
+  // recompiles continuously whenever a gate runs.
+  watchOptions: {
+    ignored: ["**/.next-gate/**", "**/.next-check/**"],
+  },
+  async redirects() {
+    return [
+      // The Philosophy page became the Introduction, the opening page of the docs.
+      { source: "/philosophy", destination: "/introduction", permanent: true },
+    ];
+  },
+};
+
+export default withMDX(nextConfig);

docs/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@native-sdk/docs",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.23.0",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm typecheck && pnpm build && node scripts/check-code-toggle.mjs"
+  },
+  "dependencies": {
+    "@mdx-js/loader": "^3",
+    "@mdx-js/react": "^3",
+    "@next/mdx": "^16.1.6",
+    "clsx": "^2.1.1",
+    "geist": "^1.7.0",
+    "next": "^16.2.9",
+    "next-themes": "^0.4.6",
+    "radix-ui": "^1.4.3",
+    "react": "^19",
+    "react-dom": "^19",
+    "remark-gfm": "^4.0.1",
+    "shiki": "^4.0.2",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss-animate": "^1.0.7"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/mdx": "^2",
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  },
+  "pnpm": {
+    "overrides": {
+      "postcss@<8.5.10": ">=8.5.10"
+    }
+  }
+}

docs/postcss.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};