Getting Started

First Steps

Bootstrap a Vista app, then pick React-only, fullstack, AI, or RAG depending on what you are building.

Updated: 2026-09-18

Create an app

Terminal

bash
npx create-vista-app@latest my-vista-app
cd my-vista-app
npm run dev

Open http://localhost:3003.

Pick a path

| Goal | Guide | | --- | --- | | Pages, layouts, client UI only | Build a React App (/docs/getting-started/react-app) | | APIs, typed procedures, auth, middleware | Build a Fullstack App (/docs/getting-started/fullstack-app) | | Chat agents, tools, streaming | AI Overview (/docs/ai/overview) | | Answers grounded in your docs | RAG (/docs/ai/rag) |

Project shape

  • app/ — routes and layouts
  • components/ — reusable UI
  • lib/ — helpers
  • app/api/ — HTTP APIs and typed API entry
  • app/agents/ — runtime AI agents (optional)
  • auth.ts / middleware.ts / /signin — after vista g auth

Tiny API smoke test

app/api/health/route.ts

ts
export async function GET() {
  return Response.json({
    ok: true,
    framework: 'vista',
    timestamp: Date.now(),
  });
}

Visit /api/health while npm run dev is running.

Continue