feat: migrate from Astro to Docus with Fly.io deployment

Replace Astro documentation site with Docus (Nuxt-based) for improved
documentation features including built-in search, dark mode, and
LLM-friendly output via nuxt-llms.

Changes:
- Remove Astro framework and React components
- Add Docus with Nuxt 4, Tailwind CSS 4, and Nuxt UI
- Migrate all documentation from MDX to Markdown with MDC syntax
- Add Fly.io deployment with Docker containerization
- Add GitHub Actions for development/production deployments
- Add justfile for common development commands
- Add Umami analytics integration

New structure:
- content/ - Documentation pages (replaces src/pages/)
- app/ - Docus configuration and custom components
- server/ - API routes (GitHub releases endpoint)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: phernandez

.dockerignore

@@ -0,0 +1,16 @@
+node_modules
+.nuxt
+.output
+dist
+.env*
+.git
+.github
+*.md
+!README.md
+.vscode
+.idea
+.DS_Store
+*.log
+coverage
+.claude
+.data

.env.development

@@ -0,0 +1,4 @@
+# Fly.io Configuration
+DOCS_APP_NAME=development-docs-basicmemory
+FLY_REGION=sjc
+NODE_ENV=production

.env.production

@@ -0,0 +1,4 @@
+# Fly.io Configuration
+DOCS_APP_NAME=production-docs-basicmemory
+FLY_REGION=sjc
+NODE_ENV=production

.github/workflows/deploy-development.yml

@@ -0,0 +1,33 @@
+name: Deploy to Development
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: development
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Fly CLI
+        uses: superfly/flyctl-actions/setup-flyctl@master
+
+      - name: Generate fly.toml
+        run: |
+          set -a
+          source .env.development
+          set +a
+          envsubst < fly.toml.template > fly.toml
+          cat fly.toml
+
+      - name: Deploy to Fly.io
+        run: |
+          GIT_SHA="${{ github.sha }}"
+          flyctl deploy --remote-only --build-arg CACHE_BUST="$GIT_SHA"
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}

.github/workflows/deploy-production.yml

@@ -0,0 +1,31 @@
+name: Deploy to Production
+
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: production
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Fly CLI
+        uses: superfly/flyctl-actions/setup-flyctl@master
+
+      - name: Generate fly.toml
+        run: |
+          set -a
+          source .env.production
+          set +a
+          envsubst < fly.toml.template > fly.toml
+          cat fly.toml
+
+      - name: Deploy to Fly.io
+        run: |
+          GIT_SHA="${{ github.sha }}"
+          flyctl deploy --remote-only --build-arg CACHE_BUST="$GIT_SHA"
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}

.github/workflows/deploy.yml

@@ -1,24 +1,33 @@
-# build output
-dist/
-# generated types
-.astro/
+# Nuxt build outputs
+.nuxt
+.output
+dist
 
-# dependencies
-node_modules/
+# Dependencies
+node_modules
 
-# logs
+# Environment files
+.env
+.env.*
+!.env.example
+!.env.development
+!.env.production
+
+# Generated fly.toml
+fly.toml
+
+# Logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
 
-
-# environment variables
-.env
-.env.production
-
-# macOS-specific files
+# macOS
 .DS_Store
 
-# jetbrains setting folder
+# IDE
 .idea/
+.vscode/
+
+# Docus data
+.data

.gitignore

@@ -0,0 +1,32 @@
+FROM node:22-bullseye AS build
+WORKDIR /app
+
+ARG CACHE_BUST=unknown
+
+# Copy package files
+COPY package.json package-lock.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source
+COPY . .
+
+# Build the application
+RUN npx nuxt prepare && npx nuxt build
+
+# Production image
+FROM node:22-slim AS prod
+
+RUN apt-get update && apt-get install -y \
+    curl \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY --from=build /app/.output ./.output
+
+EXPOSE 3000
+
+CMD ["node", ".output/server/index.mjs"]