docs: surface OpenRouter as recommended starting point (TanStack#357)

docs: surface OpenRouter as recommended starting point across getting started docs

Author: tannerlinsley

docs/adapters/openrouter.md

@@ -3,7 +3,7 @@ title: OpenRouter Adapter
 id: openrouter-adapter
 ---
 
-The OpenRouter adapter provides access to 300+ AI models from various providers through a single unified API, including models from OpenAI, Anthropic, Google, Meta, Mistral, and many more.
+OpenRouter is TanStack AI's first official AI partner and the recommended starting point for most projects. It provides access to 300+ models from OpenAI, Anthropic, Google, Meta, Mistral, and many more — all through a single API key and unified interface.
 
 ## Installation
 

docs/getting-started/overview.md

@@ -12,7 +12,7 @@ TanStack AI is a lightweight, type-safe SDK for building production-ready AI exp
 - ✅ **Streaming** - Built-in streaming support for real-time responses
 - ✅ **Isomorphic Tools** - Define once with `toolDefinition()`, implement with `.server()` or `.client()`
 - ✅ **Framework Agnostic** - Core library works anywhere
-- ✅ **Multiple Providers** - OpenAI, Anthropic, Gemini, Ollama, and more
+- ✅ **Multiple Providers** - OpenRouter, OpenAI, Anthropic, Gemini, Ollama, and more
 - ✅ **Approval Flow** - Built-in support for tool approval workflows
 - ✅ **Automatic Execution** - Both server and client tools execute automatically
 
@@ -92,10 +92,14 @@ Solid hooks for TanStack AI:
 
 With the help of adapters, TanStack AI can connect to various LLM providers. Available adapters include:
 
-- **@tanstack/ai-openai** - OpenAI (GPT-4, GPT-3.5, etc.)
+- **@tanstack/ai-openrouter** - OpenRouter (300+ models via a single API key — recommended)
+- **@tanstack/ai-openai** - OpenAI (GPT series)
 - **@tanstack/ai-anthropic** - Anthropic (Claude)
 - **@tanstack/ai-gemini** - Google Gemini
 - **@tanstack/ai-ollama** - Ollama (local models)
+- **@tanstack/ai-groq** - Groq
+- **@tanstack/ai-grok** - xAI Grok
+- **@tanstack/ai-fal** - fal (image & video generation)
 
 ## Next Steps
 

docs/getting-started/quick-start.md

@@ -6,6 +6,8 @@ order: 2
 
 Get started with TanStack AI in minutes. This guide will walk you through creating a simple chat application using the React integration and OpenAI adapter.
 
+> **Tip:** If you'd prefer not to sign up with individual AI providers, [OpenRouter](../adapters/openrouter) gives you access to 300+ models with a single API key and is the easiest way to get started.
+
 ## Installation
 
 ```bash
@@ -209,6 +211,9 @@ export function Chat() {
 
 To connect to AI providers, set your API keys in your environment variables. Create a `.env.local` file (or `.env` depending on your setup):
 ```bash
+# OpenRouter (recommended — access 300+ models with one key)
+OPENROUTER_API_KEY=sk-or-...
+
 # OpenAI
 OPENAI_API_KEY=your-openai-api-key