docs: add temporary website for docs contribution (#22469)

.website/.gitignore

@@ -0,0 +1,12 @@
+node_modules
+*.iml
+.idea
+*.log*
+.nuxt
+.vscode
+.DS_Store
+coverage
+dist
+sw.*
+.env
+.output

.website/README.md

@@ -0,0 +1,35 @@
+# Nuxt Docs Website
+
+This is a temporary directory until we open source the repository for nuxt.com.
+
+The goal is to simplify the contribution in the meantine to the documentation by having the possibility to preview the changes locally.
+
+## Setup
+
+Install dependencies in the root of the `nuxt` folder:
+
+```bash
+pnpm i
+```
+
+Then stub the dependencies:
+
+```bash
+pnpm build:stub
+```
+
+## Development
+
+In the root of the `nuxt` folder, run:
+
+```bash
+pnpm docs:dev
+```
+
+Then open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+Update the documentation within the `docs` folder.
+
+---
+
+For a detailed explanation of how things work, check out [Docus](https://docus.dev).

.website/app.config.ts

@@ -0,0 +1,14 @@
+export default defineAppConfig({
+  docus: {
+    title: 'Nuxt Docs [dev]',
+    description: 'The best place to start your documentation.',
+    socials: {
+      twitter: 'nuxt_js',
+      github: 'nuxt/nuxt'
+    },
+    aside: {
+      level: 1,
+      collapsed: false,
+    },
+  }
+})

.website/nuxt.config.ts

@@ -0,0 +1,20 @@
+import { createResolver } from 'nuxt/kit'
+
+const { resolve } = createResolver(import.meta.url)
+
+export default defineNuxtConfig({
+  // https://github.com/nuxt-themes/docus
+  extends: '@nuxt-themes/docus',
+  content: {
+    sources: {
+      docs: {
+        driver: 'fs',
+        prefix: '/',
+        base: resolve('../docs')
+      }
+    }
+  },
+  experimental: {
+    renderJsonPayloads: false
+  }
+})

.website/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "docus-starter",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "generate": "nuxt generate",
+    "preview": "nuxt preview"
+  },
+  "devDependencies": {
+    "@nuxt-themes/docus": "^1.14.6"
+  }
+}

.website/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./.nuxt/tsconfig.json"
+}

package.json

@@ -14,6 +14,7 @@
     "lint:docs": "markdownlint ./docs && case-police 'docs/**/*.md' *.md",
     "lint:docs:fix": "markdownlint ./docs --fix && case-police 'docs/**/*.md' *.md --fix",
     "lint:knip": "pnpx knip",
+    "docs:dev": "nuxi dev .website",
     "play": "nuxi dev playground",
     "play:build": "nuxi build playground",
     "play:preview": "nuxi preview playground",

pnpm-workspace.yaml

@@ -2,3 +2,4 @@ packages:
   - "packages/**"
   - "playground"
   - "test/fixtures/*"
+  - ".website"