Official Documentation
Build Fast. Write Less. Ship with Control.
Vista docs are organized using dynamic category-slug routes: /docs/<category>/<slug>. This keeps URLs stable while your content grows from basics to advanced runtime
Routing
Dynamic Slug Architecture
Catch-all routes, slug normalization, and scalable docs URL contracts.
APIs
How Vista APIs Work
Legacy route handlers + typed routers with middleware, validation, and serializers.
Structure
File Maps and Conventions
Folder-by-folder responsibilities and production-safe project organization.
Introduction
Vision, story, and why Vista exists.
Getting Started
Install, bootstrap, and build your first production path.
- First StepsBootstrap a new app, run local dev, and understand the minimum project structure in minutes.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
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, generate, and standardize team workflows.
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