Add Fly.io deploy workflow and Dockerfile

Introduces a Dockerfile and .dockerignore for containerized builds, a Fly.io deployment workflow via GitHub Actions

Author: kylemclaren

.dockerignore

@@ -0,0 +1,44 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.DS_Store
+.vercel
+.netlify
+_site/
+.astro/
+scripts/smoke/*-main/
+scripts/memory/project/src/pages/
+benchmark/projects/
+benchmark/results/
+test-results/
+*.log
+package-lock.json
+.turbo/
+.eslintcache
+.pnpm-store
+.vscode-test/
+
+# do not commit .env files or any files that end with `.env`
+*.env
+
+packages/astro/src/**/*.prebuilt.ts
+packages/astro/src/**/*.prebuilt-dev.ts
+packages/astro/test/units/_temp-fixtures/*
+!packages/astro/test/units/_temp-fixtures/package.json
+packages/integrations/**/.netlify/
+
+# exclude IntelliJ/WebStorm stuff
+.idea
+
+# ignore content collection generated files
+packages/**/test/**/fixtures/**/.astro/
+packages/**/test/**/fixtures/**/env.d.ts
+packages/**/e2e/**/fixtures/**/.astro/
+packages/**/e2e/**/fixtures/**/env.d.ts
+examples/**/.astro/
+examples/**/env.d.ts
+
+# make it easy for people to add project-specific Astro settings that they don't
+# want to share with others (see
+# https://github.com/withastro/astro/pull/11759#discussion_r1721444711)
+*.code-workspace

.github/workflows/fly-deploy.yml

@@ -0,0 +1,18 @@
+# See https://fly.io/docs/app-guides/continuous-deployment-with-github-actions/
+
+name: Fly Deploy
+on:
+  push:
+    branches:
+      - main
+jobs:
+  deploy:
+    name: Deploy app
+    runs-on: ubuntu-latest
+    concurrency: deploy-group    # optional: ensure only one action runs at a time
+    steps:
+      - uses: actions/checkout@v4
+      - uses: superfly/flyctl-actions/setup-flyctl@master
+      - run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}

.gitignore

@@ -1,3 +1,44 @@
 node_modules/
-.vitepress/dist/
-.vitepress/cache/
+dist/
+*.tsbuildinfo
+.DS_Store
+.vercel
+.netlify
+_site/
+.astro/
+scripts/smoke/*-main/
+scripts/memory/project/src/pages/
+benchmark/projects/
+benchmark/results/
+test-results/
+*.log
+package-lock.json
+.turbo/
+.eslintcache
+.pnpm-store
+.vscode-test/
+
+# do not commit .env files or any files that end with `.env`
+*.env
+
+packages/astro/src/**/*.prebuilt.ts
+packages/astro/src/**/*.prebuilt-dev.ts
+packages/astro/test/units/_temp-fixtures/*
+!packages/astro/test/units/_temp-fixtures/package.json
+packages/integrations/**/.netlify/
+
+# exclude IntelliJ/WebStorm stuff
+.idea
+
+# ignore content collection generated files
+packages/**/test/**/fixtures/**/.astro/
+packages/**/test/**/fixtures/**/env.d.ts
+packages/**/e2e/**/fixtures/**/.astro/
+packages/**/e2e/**/fixtures/**/env.d.ts
+examples/**/.astro/
+examples/**/env.d.ts
+
+# make it easy for people to add project-specific Astro settings that they don't
+# want to share with others (see
+# https://github.com/withastro/astro/pull/11759#discussion_r1721444711)
+*.code-workspace

CLAUDE.md

@@ -0,0 +1,52 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Sprites documentation site built with Astro Starlight and React components. Static site deployed to Fly.io via Docker/nginx.
+
+## Commands
+
+```bash
+bun install          # Install dependencies
+bun run dev          # Start dev server at localhost:4321
+bun run build        # Build static site to ./dist/
+bun run preview      # Preview production build locally
+```
+
+## Architecture
+
+### Tech Stack
+- **Framework**: Astro 5 with Starlight documentation theme
+- **Styling**: Tailwind CSS v4 with shadcn/ui components (OKLCH color space)
+- **Interactive**: React 19 islands with Radix UI primitives
+- **Fonts**: Self-hosted Inter (body) and JetBrains Mono (headings/code)
+
+### Project Structure
+- `src/content/docs/` - MDX documentation pages (routes based on filename)
+- `src/components/react/` - React island components for interactive elements
+- `src/components/ui/` - shadcn/ui base components (Radix-based)
+- `src/components/*.astro` - Astro wrapper components for React islands
+- `src/styles/custom.css` - Theme customization (Starlight + shadcn variables)
+- `astro.config.mjs` - Site config including sidebar structure
+
+### Component Pattern
+React components are wrapped in `.astro` files for MDX usage. The React components export from `src/components/react/index.ts`:
+- `CodeTabs`/`Snippet` - Language-tabbed code blocks
+- `Callout` - Alert/info boxes
+- `ParamTable`/`Param` - API parameter documentation
+- `APIEndpoint`/`StatusCodes` - REST API documentation
+- `BillingCalculator`/`PricingRates` - Interactive pricing tools
+
+Use `client:load` directive when importing React components in MDX.
+
+### Path Aliases
+- `@/*` → `./src/*`
+- `@components/*` → `./src/components/*`
+
+## Styling Notes
+
+- Theme uses sharp corners (`--radius: 0`, `--sl-border-radius: 0`)
+- Dark mode is default; light mode uses violet accent (hue 285), dark uses teal/green (hue ~131)
+- Tailwind v4 custom variant: `@custom-variant dark (&:is(.dark *, [data-theme="dark"] *))`

Dockerfile

@@ -0,0 +1,41 @@
+# syntax = docker/dockerfile:1
+
+ARG BUN_VERSION=1.3.2
+FROM oven/bun:${BUN_VERSION}-slim AS build
+
+WORKDIR /app
+ENV NODE_ENV="production"
+
+# Install packages needed for sharp native module
+RUN apt-get update -qq && \
+    apt-get install --no-install-recommends -y build-essential pkg-config python-is-python3 && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install dependencies
+COPY bun.lock package.json ./
+RUN bun install --frozen-lockfile
+
+# Copy and build
+COPY . .
+RUN bun run build
+
+# Final stage - minimal nginx
+FROM nginx:alpine
+
+# SPA routing + caching for static assets
+RUN printf 'server {\n\
+    listen 80;\n\
+    root /usr/share/nginx/html;\n\
+    location / {\n\
+        try_files $uri $uri/ $uri.html /index.html;\n\
+    }\n\
+    location ~* \\.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {\n\
+        expires 1y;\n\
+        add_header Cache-Control "public, immutable";\n\
+    }\n\
+}' > /etc/nginx/conf.d/default.conf
+
+COPY --from=build /app/dist /usr/share/nginx/html
+
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]