Add the typed client

With your local AppView set up, add Contrail and Atcute to your application:

pnpm add @atmo-dev/contrail @atcute/client @atcute/lexicons
pnpx @atmo-dev/contrail connect ../my-appview

Point connect at the directory containing contrail.config.ts. It resolves the source and query Lexicons, then uses Atcute to generate a typed client in src/contrail/.

Use it from your app:

import { createLocalContrailClient } from "./contrail/index.js";

const contrail = createLocalContrailClient();
const response = await contrail.get("com.example.event.listRecords", {
  params: {
    startsAtMin: new Date().toISOString(),
    limit: 20,
  },
});

if (!response.ok) throw new Error(`Contrail returned ${response.status}`);

for (const event of response.data.records) {
  console.log(event.value.name, event.value.startsAt);
}

The method name, parameters, and response are all typed from the Lexicons. Re-run connect when the AppView config changes.

Next: configure filters, sorting, and hydration . To use an existing deployed AppView, pass its HTTPS URL to contrail connect instead of a config path.