Reference

Typed Client Reference

Use `createVistaClient<AppRouter>()` with `$get`, `$post`, and `$url` helpers for typed request contracts.

Updated: 2026-03-04

Client Initialization

ts

ts
import { createVistaClient } from 'vista/stack/client';
import { router } from '@/app/api/typed';

type AppRouter = typeof router;

const client = createVistaClient<AppRouter>({
  baseUrl: '/api',
  serialization: 'json',
});

Request Helpers

  • `client.$get(path, input?)` for read operations.
  • `client.$post(path, input?)` for write operations.
  • `client.$url(path, input?)` when you need a fully built URL.

Error Shape

Failed requests throw `VistaClientError` with status, message, path, method, url, and optional details payload.

ts

ts
try {
  await client.$post('/users/create', { email: 'hello@vista.dev' });
} catch (error) {
  if (error instanceof Error) {
    console.error(error.message);
  }
}

Related