Initialize Nextra → Starlight migration script

Author: moonclavedev

.gitignore

@@ -21,4 +21,7 @@ pnpm-debug.log*
 # macOS-specific files
 .DS_Store
 
-.vercel/
+.vercel/
+
+nextra-migration/
+starlight-docs/

eslint.config.js

@@ -26,6 +26,7 @@ const config = [
       "**/package-lock.json",
       "**/pnpm-lock.yaml",
       "**/public",
+      "**/scripts/migration",
     ],
   },
 

package.json

@@ -3,6 +3,7 @@
   "type": "module",
   "version": "0.0.1",
   "scripts": {
+    "migrate": "cd scripts/migration && pnpm install && pnpm migrate",
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",

scripts/migration/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "nextra-to-starlight-migration",
+  "version": "1.0.0",
+  "description": "Migration script to transform Nextra docs to Starlight format",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "migrate": "npm run build && node dist/migrate.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@types/node": "^22.13.1",
+    "glob": "^11.0.1",
+    "ts-morph": "^25.0.1",
+    "typescript": "^5.7.3"
+  }
+}