skrypt-ai 0.3.4 → 0.4.1

package/dist/template/src/app/docs/configuration/page.mdx

@@ -0,0 +1,86 @@
+---
+title: Configuration
+description: Configure Skrypt with skrypt.config.yaml
+---
+
+Configure Skrypt behavior with a `skrypt.config.yaml` file.
+
+## Basic Configuration
+
+```yaml
+source: ./src
+output: ./docs/src/app/docs
+provider: openai
+model: gpt-4o
+```
+
+## Full Reference
+
+```yaml
+output: ./docs
+
+model: gpt-4o             # Model name
+baseUrl: null             # Custom API URL (for Ollama/proxies)
+
+  publicOnly: true        # Only document exported/public APIs
+  multiLang: false        # Generate TypeScript + Python examples
+  byTopic: false          # Organize by topic instead of file structure
+  llmsTxt: true           # Generate llms.txt for AEO
+  projectName: "My Project"
+
+  - "**/*.test.ts"
+  - "**/__tests__/**"
+  - "name:internal*"
+  - "name:_*"
+
+```
+
+## Environment Variables
+
+```bash
+export OPENAI_API_KEY=sk-...
+export ANTHROPIC_API_KEY=sk-ant-...
+export DEEPSEEK_API_KEY=sk-...
+```
+
+## Provider Examples
+
+### OpenAI
+
+```yaml
+provider: openai
+model: gpt-4o
+```
+
+### Anthropic
+
+```yaml
+provider: anthropic
+model: claude-sonnet-4-6
+```
+
+### Ollama (Local)
+
+```yaml
+provider: ollama
+model: llama3.2
+baseUrl: http://localhost:11434
+```
+
+## Exclusion Patterns
+
+### File Patterns
+
+```yaml
+exclude:
+  - "**/*.test.ts"
+  - "**/internal/**"
+```
+
+### Name Patterns
+
+```yaml
+exclude:
+  - "name:_*"           # Private
+  - "name:internal*"    # Internal functions
+```

package/dist/template/src/app/docs/deployment/page.mdx

@@ -0,0 +1,112 @@
+---
+title: Deployment Guide
+description: Deploy your Skrypt documentation site
+---
+
+## Quick Deploy (Skrypt Cloud)
+
+```bash
+skrypt deploy
+```
+
+Your docs will be live at `https://your-project.skrypt.sh`.
+
+## Self-Hosted Setup
+
+### Prerequisites
+
+- Node.js 18+
+- Supabase account
+- Cloudflare account
+- Vercel account
+
+### 1. Clone and Install
+
+```bash
+git clone https://github.com/debgotwired/skrypt
+cd skrypt
+npm install
+npm run build
+```
+
+### 2. Supabase Setup
+
+```bash
+cd landing
+npx supabase login
+npx supabase link --project-ref YOUR_PROJECT_REF
+npx supabase db push
+```
+
+### 3. Environment Variables
+
+Create `.env.local`:
+
+```bash
+NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
+SUPABASE_SERVICE_ROLE_KEY=eyJ...
+
+STRIPE_SECRET_KEY=sk_live_...
+OPENAI_API_KEY=sk-...
+
+NEXT_PUBLIC_APP_URL=https://skrypt.sh
+```
+
+### 4. Deploy Landing
+
+```bash
+cd landing
+vercel
+```
+
+### 5. Cloudflare Pages
+
+For user docs hosting:
+
+1. Create Cloudflare Pages project
+2. Configure wildcard DNS: `*.skrypt.sh`
+
+### 6. Stripe Webhooks
+
+URL: `https://skrypt.sh/api/webhooks/stripe`
+
+Events:
+- `checkout.session.completed`
+- `customer.subscription.updated`
+- `customer.subscription.deleted`
+
+---
+
+## CLI Installation
+
+### npm
+
+```bash
+npm install -g skrypt-ai
+```
+
+### Homebrew
+
+```bash
+brew tap debgotwired/tap
+brew install skrypt
+```
+
+---
+
+## Troubleshooting
+
+### "API_KEY required"
+
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+### Build Errors
+
+```bash
+rm -rf node_modules
+npm install
+npm run build
+```

package/dist/template/src/app/docs/error.tsx

@@ -0,0 +1,20 @@
+'use client'
+
+export default function DocsError({ error, reset }: { error: Error; reset: () => void }) {
+  return (
+    <div className="flex-1 flex items-center justify-center min-h-[50vh]">
+      <div className="text-center max-w-md">
+        <h2 className="text-xl font-semibold text-[var(--color-text)] mb-2">Something went wrong</h2>
+        <p className="text-[0.875rem] text-[var(--color-text-secondary)] mb-4">
+          {error.message || 'An error occurred while loading this page.'}
+        </p>
+        <button
+          onClick={reset}
+          className="px-4 py-2 bg-[var(--color-primary)] text-[var(--color-primary-foreground)] rounded-lg text-[0.875rem] font-medium hover:opacity-90 transition-opacity"
+        >
+          Try again
+        </button>
+      </div>
+    </div>
+  )
+}