HarborHarbor
DocumentationGuidesPlugins

Apps

Hosted HTTP surfaces published with deployApp.

Apps are small hosted HTTP surfaces backed by Harbor execution. Author them with deployApp and inspect their URL and metadata through hrbr.apps.

Apps

Apps are useful for internal dashboards, public intake forms, webhook endpoints, and lightweight reports that need Harbor workspace context.

status.app.ts
deployApp({
  id: "statusPage",
  title: "Status Page",
  access: "public",
  routes: {
    "GET /": {
      staticHtml: "<h1>All systems checked by Harbor</h1>",
    },
  },
})
hrbr inspect -f ./status.app.ts
hrbr inspect 'return await hrbr.apps.open({ name: "status-page" })'
hrbr inspect 'return await hrbr.apps.inspect({ name: "status-page" })'

Use public routes only for read-only or collect-only flows. Put privileged workspace actions behind workspace_member routes or private Functions.

Authoring guide

Route shape, access modes, and publish workflow.

Your first App

Publish and open a minimal app.

On this page

Apps