Skip to content

secondsky/claude-skills / plugins/tanstack-ai/skills/tanstack-ai

tanstack-ai

Verified

TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama. Use for chat APIs, React/Solid frontends with useChat/ChatClient, isomorphic tools, tool approval flows, agent loops, multimodal inputs, or troubleshooting streaming and tool definitions.

references/start-vs-next-routing.md

View on GitHub
# TanStack Start vs Next.js Routing (Streaming Chat)

## TanStack Start
```
src/routes/api/chat.ts
```
```ts
import { chat, toStreamResponse } from '@tanstack/ai'
import { openai } from '@tanstack/ai-openai'
import { tools } from '@/tools/definitions'

export async function POST({ request }: { request: Request }) {
  const { messages } = await request.json()
  const stream = chat({ adapter: openai(), model: 'gpt-4o', messages, tools })
  return toStreamResponse(stream)
}
```
Notes:
- File-based routes; exports align with HTTP verbs.
- Runs on the same runtime as Start server functions; streaming works by default.

## Next.js (App Router)
```
app/api/chat/route.ts
```
```ts
import { chat, toStreamResponse } from '@tanstack/ai'
import { openai } from '@tanstack/ai-openai'
import { tools } from '@/tools/definitions'

export const runtime = 'edge' // optional but recommended for streaming

export async function POST(req: Request) {
  const { messages } = await req.json()
  const stream = chat({ adapter: openai(), model: 'gpt-4o', messages, tools })
  return toStreamResponse(stream)
}
```
Notes:
- Use `runtime = 'edge'` for lowest latency; for Node runtime ensure `dynamic = 'force-dynamic'` if needed.
- In dev, Next auto-handles chunked responses; in prod verify proxy allows streaming.

## Client hookup (same for both)
```tsx
const { messages } = useChat({
  connection: fetchServerSentEvents('/api/chat'),
  tools: clientTools(showToast),
})
```

## Path & Import Differences
- Start: `src/routes/...` and absolute imports often use `$lib` aliases.  
- Next: `app/api/...` and `@/` alias maps to `src/`.

## Testing
- Run `pnpm dev` and hit `/api/chat` with `curl -N` to confirm streaming:
  `curl -N -X POST -H "Content-Type: application/json" --data '{"messages":[{"role":"user","content":"ping"}]}' http://localhost:3000/api/chat`
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall