feat(starlight): start structure for the migration

.gitignore

@@ -35,3 +35,7 @@ yarn-error.log*
 next-env.d.ts
 
 .contentlayer
+
+# Astro
+/.astro
+/dist

astro.config.mts

@@ -0,0 +1,16 @@
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+
+// https://astro.build/config
+export default defineConfig({
+  srcDir: "./astro",
+  integrations: [
+    starlight({
+      // https://starlight.astro.build/reference/configuration
+      title: "Ada URL",
+      social: {
+        github: "https://github.com/ada-url/ada",
+      },
+    }),
+  ],
+});

astro/content/config.ts

@@ -0,0 +1,6 @@
+import { defineCollection } from "astro:content";
+import { docsSchema } from "@astrojs/starlight/schema";
+
+export const collections = {
+  docs: defineCollection({ schema: docsSchema() }),
+};

astro/content/docs/index.md

@@ -0,0 +1,8 @@
+---
+title: "Ada URL Parser - Fast WHATWG Compliant URL parser"
+description: WHATWG Compliant URL parser written with focus on compliance, performance and security across multiple platforms and languages.
+template: splash
+next: false
+---
+
+Meet Ada: WHATWG Compliant URL Parser

astro/env.d.ts

@@ -0,0 +1 @@
+/// <reference path="../.astro/types.d.ts" />

package.json

@@ -6,10 +6,13 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
+    "dev-astro": "astro dev",
+    "build-astro": "astro build",
     "lint": "biome check . && biome format .",
     "lint-fix": "biome check . --write --unsafe && biome format . --write"
   },
   "dependencies": {
+    "@astrojs/starlight": "^0.26.1",
     "@radix-ui/react-accordion": "^1.1.2",
     "@radix-ui/react-aspect-ratio": "^1.0.3",
     "@radix-ui/react-collapsible": "^1.0.3",
@@ -24,6 +27,7 @@
     "@types/react": "18.2.24",
     "@types/react-dom": "18.2.8",
     "@vercel/analytics": "^1.0.2",
+    "astro": "^4.14.2",
     "autoprefixer": "10.4.16",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",

src/env.d.ts

@@ -0,0 +1,2 @@
+/// <reference path="../astro/.astro/types.d.ts" />
+/// <reference path="../.astro/types.d.ts" />