Claude Code

I'm building with Stack0 (stack0.dev) for email and file storage.
 
Documentation: https://stack0.dev/llms.txt
 
Stack0 provides:
- Transactional & marketing email (stack0.mail.send)
- File storage with CDN (stack0.cdn.getUploadUrl)
- Image processing & transforms
- Screenshots of URLs
- AI data extraction from web pages
 
SDK: @stack0/sdk
API Key: process.env.STACK0_API_KEY

# Project Context for Claude
 
## Stack0 Integration
 
This project uses Stack0 for infrastructure services.
 
### Setup
```bash
npm install @stack0/sdk
```
 
### Environment
```
STACK0_API_KEY=sk_live_your_api_key
```
 
### SDK Initialization
```typescript
import { Stack0 } from '@stack0/sdk'
 
const stack0 = new Stack0({
  apiKey: process.env.STACK0_API_KEY!
})
```
 
## Common Patterns
 
### Send Email
```typescript
await stack0.mail.send({
  from: 'noreply@myapp.com',
  to: 'user@example.com',
  subject: 'Hello!',
  html: '<h1>Welcome!</h1>',
})
```
 
### Upload File to CDN
```typescript
// Get presigned upload URL
const { uploadUrl, cdnUrl, assetId } = await stack0.cdn.getUploadUrl({
  filename: 'image.png',
  mimeType: 'image/png',
  size: fileSize,
})
 
// Upload directly
await fetch(uploadUrl, { method: 'PUT', body: fileBuffer })
 
// Confirm upload
await stack0.cdn.confirmUpload({ assetId })
```
 
### Take Screenshot
```typescript
const screenshot = await stack0.screenshots.capture({
  url: 'https://example.com',
  format: 'png',
  fullPage: false,
})
// screenshot.url contains the image
```
 
### Extract Data from URL
```typescript
const data = await stack0.extraction.extract({
  url: 'https://example.com/article',
  schema: {
    title: 'string',
    content: 'string',
    author: 'string',
  },
})
```
 
## Documentation
Full API reference: https://stack0.dev/llms.txt

Help me add email functionality to my Next.js app.
 
I need:
1. A shared Stack0 client in lib/stack0.ts
2. An API route at app/api/email/send/route.ts
3. A reusable sendEmail utility function
4. Email templates for: welcome, password reset, notification
 
Use Stack0 SDK (@stack0/sdk) - see CLAUDE.md for setup.
The API key is in STACK0_API_KEY env variable.
 
Please implement all files and explain the structure.

// lib/stack0.ts
import { Stack0 } from '@stack0/sdk'
 
if (!process.env.STACK0_API_KEY) {
  throw new Error('Missing STACK0_API_KEY environment variable')
}
 
export const stack0 = new Stack0({
  apiKey: process.env.STACK0_API_KEY,
})
 
// Email utilities
export async function sendEmail(options: {
  to: string
  subject: string
  html: string
  from?: string
}) {
  return stack0.mail.send({
    from: options.from || 'noreply@myapp.com',
    to: options.to,
    subject: options.subject,
    html: options.html,
  })
}
 
// File upload utilities
export async function getUploadUrl(file: { name: string; type: string; size: number }) {
  return stack0.cdn.getUploadUrl({
    filename: file.name,
    mimeType: file.type,
    size: file.size,
  })
}
 
export async function confirmUpload(assetId: string) {
  return stack0.cdn.confirmUpload({ assetId })
}

// app/api/email/send/route.ts
import { sendEmail } from '@/lib/stack0'
import { NextResponse } from 'next/server'
import { z } from 'zod'
 
const emailSchema = z.object({
  to: z.string().email(),
  subject: z.string().min(1),
  html: z.string().min(1),
})
 
export async function POST(request: Request) {
  try {
    const body = await request.json()
    const { to, subject, html } = emailSchema.parse(body)
 
    const result = await sendEmail({ to, subject, html })
 
    return NextResponse.json({ 
      success: true, 
      messageId: result.id 
    })
  } catch (error) {
    if (error instanceof z.ZodError) {
      return NextResponse.json(
        { error: 'Invalid request', details: error.errors },
        { status: 400 }
      )
    }
 
    console.error('Email send failed:', error)
    return NextResponse.json(
      { error: 'Failed to send email' },
      { status: 500 }
    )
  }
}