v3 docs: Migrate to Malta (#1296)

.github/workflows/v3-docs.yaml

@@ -18,14 +18,15 @@ jobs:
         with:
           node-version: 20.5.1
           registry-url: https://registry.npmjs.org
-      - name: install dependencies
+      - name: install malta
+        working-directory: docs
         run: |
-          npm i -g pnpm
-          pnpm i --no-frozen-lockfile
+          curl -o malta.tgz -L https://github.com/pilcrowonpaper/malta/releases/latest/download/linux-amd64.tgz
+          tar -xvzf malta.tgz
+      - name: build
+        working-directory: docs
+        run: ./linux-amd64/malta
       - name: install wrangler
         run: npm i -g wrangler
-      - name: build
-        working-directory: documentation
-        run: pnpm build
       - name: deploy
-        run: wrangler pages deploy documentation/dist --project-name lucia-v3 --branch main
+        run: wrangler pages deploy docs/dist --project-name malta-cli --branch main

docs/.gitignore

@@ -0,0 +1,2 @@
+dist
+.DS_Store

docs/malta.config.json

@@ -0,0 +1,55 @@
+{
+	"name": "Lucia",
+	"description": "Lucia is an open source auth library that abstracts away the complexity of handling sessions.",
+	"domain": "https://v3.lucia-auth.com",
+	"twitter": "@lucia_auth",
+	"sidebar": [
+		{
+			"title": "Start here",
+			"pages": [
+				["Getting-started", "/getting-started"],
+				["Database", "/database"],
+				["Upgrade to v3", "/upgrade-v3"]
+			]
+		},
+		{
+			"title": "Tutorials",
+			"pages": [
+				["GitHub OAuth", "/tutorials/github-oauth"],
+				["Username and password", "/tutorials/username-and-password"]
+			]
+		},
+		{
+			"title": "Basics",
+			"pages": [
+				["Sessions", "/basics/sessions"],
+				["Users", "/basics/users"],
+				["Configuration", "/basics/configuration"],
+				["Troubleshooting", "/basics/help"]
+			]
+		},
+		{
+			"title": "Guides",
+			"pages": [
+				["Validate session cookies", "/guides/validate-session-cookies"],
+				["Validate bearer tokens", "/guides/validate-bearer-tokens"],
+				["OAuth", "/guides/oauth"],
+				["Email and password", "/guides/email-and-password"],
+				["Passkeys", "/guides/passkeys"],
+				["Improving sessions", "/guides/improving-sessions"]
+			]
+		},
+		{
+			"title": "API reference",
+			"pages": [["lucia", "/reference/main", "code"]]
+		},
+		{
+			"title": "Community",
+			"pages": [
+				["Discord", "https://discord.com/invite/PwrK3kpVR3"],
+				["GitHub", "https://github.com/lucia-auth/lucia"],
+				["Twitter", "https://twitter.com/lucia-auth"]
+			]
+		}
+	]
+}

docs/pages/tutorials/github-oauth/astro.md

@@ -0,0 +1,3 @@
+---
+title: "GitHub OAuth in Astro"
+---

docs/pages/tutorials/github-oauth/nextjs-app.md

@@ -0,0 +1,3 @@
+---
+title: "GitHub OAuth in Next.js App router"
+---

docs/pages/tutorials/github-oauth/nextjs-pages.md

@@ -0,0 +1,3 @@
+---
+title: "GitHub OAuth in Next.js Pages router"
+---

docs/pages/tutorials/github-oauth/sveltekit.md

@@ -0,0 +1,3 @@
+---
+title: "GitHub OAuth in SvelteKit"
+---

docs/pages/tutorials/username-and-password/astro.md

@@ -0,0 +1,3 @@
+---
+title: "Username and password in Astro"
+---

docs/pages/tutorials/username-and-password/nextjs-app.md

@@ -0,0 +1,3 @@
+---
+title: "Username and password in Next.js App Router"
+---

docs/pages/tutorials/username-and-password/nextjs-pages.md

@@ -0,0 +1,3 @@
+---
+title: "Username and password in Next.js Pages Router"
+---

docs/pages/tutorials/username-and-password/sveltekit.md

@@ -0,0 +1,3 @@
+---
+title: "Username and password in SvelteKit"
+---