feat: rewrite with Starlight

.editorconfig

@@ -5,9 +5,6 @@ charset = utf-8
 end_of_line = lf
 indent_style = space
 indent_size = 2
-max_line_length = 100
+max_line_length = 120
 insert_final_newline = true
 trim_trailing_whitespace = true
-
-[{*.md,*.mdx}]
-indent_size = 4

.github/workflows/build-preview.yaml

@@ -22,19 +22,18 @@ jobs:
         with:
           cache: "pnpm"
           node-version: 20
+      - name: "setup d2"
+        run: "curl -fsSL https://d2lang.com/install.sh | sh -s --"
       - name: "install dependencies"
         run: "pnpm install"
       - name: "build"
-        run: "pnpm run build"
-        env:
-          CI_ENV: preview
-          GITHUB_PR_HEAD_OWNER: ${{ github.event.pull_request.head.repo.owner.login }}
+        run: "pnpm build"
       - name: "copy cloudflare configuration files to build directory"
         run: |
-          cp _headers build/
-          cp _redirects build/
+          cp _headers dist/
+          cp _redirects dist/
       - name: "upload build artifact"
         uses: "actions/upload-artifact@v4"
         with:
           name: "preview-build"
-          path: "build"
+          path: "dist"

.github/workflows/deploy-preview.yaml

@@ -23,7 +23,7 @@ jobs:
         id: "preview-build-artifact"
         with:
           name: "preview-build"
-          path: "build"
+          path: "dist"
           github-token: ${{ secrets.GITHUB_TOKEN }}
           run-id: ${{ github.event.workflow_run.id }}
       - name: "Deploy to Cloudflare Pages"

.github/workflows/deploy.yaml

@@ -24,16 +24,16 @@ jobs:
         with:
           cache: "pnpm"
           node-version: 20
+      - name: "setup d2"
+        run: "curl -fsSL https://d2lang.com/install.sh | sh -s --"
       - name: "install dependencies"
         run: "pnpm install"
       - name: "build"
-        run: "pnpm run build"
-        env:
-          CI_ENV: production
+        run: "pnpm build"
       - name: "copy cloudflare configuration files to build directory"
         run: |
-          cp _headers build/
-          cp _redirects build/
+          cp _headers dist/
+          cp _redirects dist/
       - name: "publish (push)"
         id: "cloudflare-publish"
         uses: "AdrianGonz97/refined-cf-pages-action@v1"
@@ -42,5 +42,5 @@ jobs:
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           projectName: "papermc-docs"
           deploymentName: "Production"
-          directory: "build"
-          gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+          directory: "dist"
+          githubToken: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/format.yaml

@@ -23,4 +23,4 @@ jobs:
       - name: Install dependencies
         run: pnpm install
       - name: Check format
-        run: pnpm run format:check
+        run: pnpm format:check

.gitignore

@@ -1,10 +1,24 @@
-/.idea
-/node_modules
-/build
-/.vscode
-/.docusaurus
-.cache-loader
-.DS_Store
+# build output
+dist/
+# generated types
+.astro/
+.cache/
+
+# dependencies
+node_modules/
+
+# logs
 npm-debug.log*
-.pnp.*
-/.meta
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+.idea/

.prettierignore

@@ -1,6 +1,9 @@
 pnpm-lock.yaml
-docs/versioned
+pnpm-workspace.yaml
 *.md
 *.mdx
-!README.md
-!CONTRIBUTING.md
+public/d2
+
+# Prettier has issues with Astro
+src/components/overrides/Head.astro
+src/components/ConfigNode.astro

.prettierrc.json

@@ -2,5 +2,21 @@
   "arrowParens": "always",
   "singleQuote": false,
   "semi": true,
-  "trailingComma": "es5"
+  "trailingComma": "es5",
+  "plugins": ["prettier-plugin-astro", "prettier-plugin-svelte", "prettier-plugin-organize-imports"],
+  "organizeImportsSkipDestructiveCodeActions": true,
+  "overrides": [
+    {
+      "files": "*.astro",
+      "options": {
+        "parser": "astro"
+      }
+    },
+    {
+      "files": "*.svelte",
+      "options": {
+        "parser": "svelte"
+      }
+    }
+  ]
 }

.typos.toml

@@ -1,6 +1,6 @@
 [files]
 extend-exclude = [
-    "docs/versioned" # old documentation shouldn't be checked
+  "public/d2" # D2 output shouldn't be checked
 ]
 
 [default]

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}