Deploying Apps

Deploy a directory or generated files with deployApp(), repair TypeScript, and configure regions and scaling.

Deploy a directory:

await deployApp({
  appId: "hello-world",
  source: new URL("../fixtures/app/", import.meta.url),
});

Or deploy generated files:

await deployApp({
  appId: "generated-app",
  files: {
    "index.html": "<h1>Hello</h1>",
  },
});

TypeScript repair

deployApp() returns build diagnostics when generated TypeScript does not compile. An agent can use those diagnostics to repair the files and call deployApp() again:

for (let attempt = 0; attempt < 3; attempt++) {
  try {
    await deployApp({ appId: "generated-app", files });
    break;
  } catch (error) {
    if (attempt === 2) throw error;
    files = await repairWithAgent(files, String(error));
  }
}

A failed build does not replace the currently active release. See the AI App Builder example.

appId must contain 1–63 lowercase letters, numbers, or hyphens. Pass exactly one of source or files.

Configuration

await deployApp({
  appId: "my-app",
  source,
  regions: ["atl", "fra"],
  createNamespace: true,
  scaling: {
    minReplicas: 0,
    maxReplicas: 128,
    targetConcurrency: 8,
  },
});

By default, apps use the namespace configured on the ordinary Rivet client. Enable createNamespace only when the app needs its own namespace; it requires Rivet namespace list and create permissions.