Getting Started

First Steps

Bootstrap a new app, run local dev, and understand the minimum project structure in minutes.

Updated: 2026-03-04

Create an App

Terminal

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

Project Shape

  • `app/` contains pages and layouts.
  • `components/` stores reusable UI.
  • `data/` and `lib/` keep content + helpers clean.

What to Build First

Start with one route, one layout, and one data source. Keep scope tight until your core loop is stable.

First API Implementation

app/api/health/route.ts

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