Official Documentation
Build a React app. Grow it into fullstack, auth, and AI.
Start with pages under app/. Add route.ts or vista g api-init for APIs, vista g auth for sessions, and vista g agent for chat and RAG. Same project, no second server.
React
Build a React App
Pages, layouts, Server Components, and client UI under app/ — no backend required.
Fullstack
APIs, auth, middleware
route.ts, typed procedures, vista g auth, and fail-closed middleware in the same app.
AI
Agents and RAG
vista g agent, Groq and NVIDIA models, embeddings, and retrieval over your docs.
Introduction
Vision, story, and why Vista exists.
Getting Started
Install, bootstrap, then pick React-only, fullstack, auth, or AI.
- First StepsBootstrap a Vista app, then pick React-only, fullstack, AI, or RAG depending on what you are building.Open
- Project StructureUnderstand what each folder does so you can add routes, APIs, and shared logic without creating chaos.Open
- Typed API QuickstartEnable the experimental typed API flag and wire your first router in minutes with strongly typed contracts.Open
- Build a React AppUse Vista like a normal React App Router project: pages, layouts, Server Components, and client UI.Open
- Build a Fullstack AppAdd APIs, typed procedures, auth, and middleware in the same Vista app that serves your React UI.Open
Core Concepts
Routing, APIs, runtime behavior, and architecture contracts.
- Routing OverviewUnderstand static, dynamic, and catch-all routes so app structure scales without rewrites.Open
- Dynamic Routes and SlugsUse dynamic segments and catch-all routes to build scalable URL systems for docs, blogs, and dashboards.Open
- API Routes vs Typed APIVista supports both classic route handlers and the new typed API runtime so teams can migrate incrementally.Open
- Typed API Runtime FlowFollow the exact request lifecycle from incoming `/api/*` call to router execution and serialized response.Open
CLI Workflow
Scaffold with create-vista-app, then vista g auth, api-init, or agent.
Reference
Config options, API signatures, and file maps.
- Vista Config ReferenceReference for `vista.config.ts` including server settings, image config, and experimental typed API flags.Open
- Project File StructureDetailed map of important Vista folders and how runtime, routes, and docs content connect to each other.Open
- Typed Client ReferenceUse `createVistaClient<AppRouter>()` with `$get`, `$post`, and `$url` helpers for typed request contracts.Open
- Bench ArchitectureHow Vista benchmark fixtures, runner modes, and validation checks are organized.Open
- Engine Variants: Default vs FlashpackHow benchmark and CLI engine variants map to Vista runtime paths.Open
- Flashpack ArchitectureRust workspace layout and runtime flow for Vista Flashpack.Open
- Rust Crates and NAPI BridgeHow Vista's Rust crates and `vista-napi` bridge are organized today, and how that differs from the larger Next.js Rust surface.Open
Deployment
Release, publish, and production checks.
- Deployment Platform MatrixFeature support and recommended targets for Vista apps on major hosting providers.Open
- Vista Deploy CommandDeploy Vista apps with npm run deploy or vista deploy across Render, Vercel, Cloudflare, Netlify, and Docker.Open
- Render DeploymentDeploy full-feature Vista apps to Render with npm run deploy or render.yaml.Open
- Vercel DeploymentDeploy Vista Flight SSR to Vercel as a Node.js serverless function.Open
- Cloudflare DeploymentDeploy Vista Flight SSR on Cloudflare Containers, or static Pages when you opt in.Open
- Netlify DeploymentDeploy Vista Flight SSR to Netlify as a Node function.Open
AI Framework
Agents, Groq/NVIDIA models, streaming, embeddings, and RAG.
- AI Framework OverviewBuild native AI applications, agents, tools, and streaming workflows directly in Vista.js.Open
- Defining Agents & ToolsLearn how to configure agents, multi-step tool reasoning loops, and multi-agent hierarchies in Vista.Open
- Streaming & UI HooksStream agent responses in real time using Server-Sent Events (SSE) and the useAgent React hook.Open
- Model Providers ConfigurationConfigure OpenAI, Anthropic, Google Gemini, Groq, NVIDIA NIM, Ollama, and local models in Vista.Open
- RAG with Vista AIIndex your documents, retrieve the best chunks, and answer with an agent tool — with or without an embedding API.Open
Authentication
vista g auth, credentials POST, OAuth callbackUrl, fail-closed middleware.