Switch to commit-generated-docs approach

- Generate CLI docs in CI, commit result (not generated on every build)
- Simplify Dockerfile: remove CLI installation
- Remove prebuild hook from package.json
- Keep generate:api for API docs (still generated on build)
- Add Callout margin fix
- Update checkpoints.mdx to use Callout component

This approach:
- Makes Docker builds simpler and faster
- Makes deploys more reliable (no external API dependency)
- Makes doc changes visible in PRs for review

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: kylemclaren

.github/workflows/ci.yml

@@ -46,6 +46,9 @@ jobs:
         env:
           SPRITES_TEST_TOKEN: ${{ secrets.SPRITES_TEST_TOKEN }}
 
+      - name: Generate CLI Docs
+        run: pnpm generate:cli-docs
+
       - name: Build
         run: pnpm build
 

.gitignore

@@ -55,9 +55,8 @@ styles/write-good/
 # Sprites CLI local config
 .sprite
 
-# Generated CLI documentation (rebuilt on deploy)
+# CLI test reports
 cli-test-report.json
-src/content/docs/cli/commands.mdx
 
 # Generated API documentation (rebuilt on deploy)
 src/content/docs/api/

Dockerfile

@@ -8,22 +8,17 @@ ENV NODE_ENV="production"
 # Install pnpm
 RUN corepack enable && corepack prepare pnpm@latest --activate
 
-# Install packages needed for sharp native module and CLI
+# Install packages needed for sharp native module
 RUN apt-get update -qq && \
-    apt-get install --no-install-recommends -y build-essential git pkg-config python-is-python3 curl ca-certificates && \
+    apt-get install --no-install-recommends -y build-essential git pkg-config python-is-python3 && \
     rm -rf /var/lib/apt/lists/*
 
-# Install Sprites CLI
-RUN curl -fsSL https://sprites.dev/install.sh | bash
-ENV PATH="/root/.local/bin:$PATH"
-
 # Install dependencies
 COPY package.json pnpm-lock.yaml* ./
 RUN pnpm install --frozen-lockfile || pnpm install
 
-# Copy and build (skip CLI tests in Docker - no API access)
+# Copy and build
 COPY . .
-ENV SKIP_CLI_TESTS=true
 RUN pnpm run build
 
 # Final stage - minimal nginx

package.json

@@ -7,7 +7,6 @@
     "generate:cli-docs": "tsx scripts/generate-cli-docs/index.ts",
     "dev": "pnpm generate:api && astro dev",
     "start": "pnpm generate:api && astro dev",
-    "prebuild": "pnpm generate:cli-docs",
     "build": "pnpm generate:api && astro build",
     "preview": "astro preview",
     "lint": "biome check",

src/components/react/Callout.tsx

@@ -34,10 +34,12 @@ export function Callout({ type = 'info', title, children }: CalloutProps) {
   const Icon = icons[type];
 
   return (
-    <Alert className={cn('my-6', styles[type])}>
-      <Icon />
-      {title && <AlertTitle className={titleStyles[type]}>{title}</AlertTitle>}
-      <AlertDescription className="[&>p]:m-0">{children}</AlertDescription>
-    </Alert>
+    <div style={{ marginTop: '2.5rem', marginBottom: '1.5rem' }}>
+      <Alert className={cn(styles[type])}>
+        <Icon />
+        {title && <AlertTitle className={titleStyles[type]}>{title}</AlertTitle>}
+        <AlertDescription className="[&>p]:m-0 justify-items-stretch">{children}</AlertDescription>
+      </Alert>
+    </div>
   );
 }

src/content/docs/concepts/checkpoints.mdx

@@ -5,7 +5,7 @@ draft: true
 ---
 
 import { Tabs, TabItem } from '@astrojs/starlight/components';
-import { Snippet, LinkCard, CardGrid } from '@/components/react';
+import { Snippet, LinkCard, CardGrid, Callout } from '@/components/react';
 
 **Sprites are programmable Linux environments you can spin up, script, and share. Checkpoints let you save a Sprite's entire state and bring it back later.** They capture persistent state: your filesystem, installed packages, environment config, dotfiles. They don't include running processes, network connections, or anything in memory.
 
@@ -284,16 +284,19 @@ Deleted
 </TabItem>
 </Tabs>
 
-### Delete Restrictions
-
+<Callout type="warning" title="Delete Restrictions" client:load>
 You cannot delete the currently active checkpoint. Attempting to do so returns an error:
 
 ```bash
 sprite checkpoint delete v2
-# Error: cannot delete active checkpoint
+```
+
+```output
+Error: cannot delete active checkpoint
 ```
 
 To delete an active checkpoint, first restore to a different checkpoint, then delete the original.
+</Callout>
 
 ### Cleanup Considerations