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"
+---