Build apps for Reintersect

​

Start with what you’re building

​

How an app reaches a workspace

1. You create the app in Settings → Developer → Apps, let reintersect dev create a personal one for you, or ask a coding agent in Reintersect to build one. Any member can build apps, and a development install is visible only to you.
2. A workspace owner or admin installs it from its install link. The consent screen lists the scopes, outbound hosts, claimed link domains, events and actions the app uses. See Install and consent.
3. Members use its blocks, references, commands and message actions. Reintersect calls your app over signed HTTPS when something needs your code, and stores the results.
4. You ship new versions with reintersect deploy or the GitHub Action. A version that asks for no new access rolls out to every install on its own. A version that widens access waits for an admin to approve it.

​

A first look

import { choice, createReintersectApp, defineBlock } from "@reintersect/sdk/app";
import { Block, ChoiceGroup, Header, Icon } from "@reintersect/sdk/components";
import { z } from "zod";

export const GoNoGo = defineBlock({
  type: "go-no-go",
  title: "Go / no-go",
  insertable: true,
  props: z.object({ title: z.string() }),
  state: z.object({}),
  initialState: {},
  inputs: { verdict: choice(["go", "nogo"]) },
}).render((props, { inputs }) => (
  <Block summary={`Go / no-go: ${props.title}`}>
    <Header leading={<Icon name="rocket" />}>{props.title}</Header>
    <ChoiceGroup
      input={inputs.verdict}
      label="Your call"
      labels={{ go: "Go", nogo: "No go" }}
      appearance="segmented"
    />
  </Block>
));

export const app = createReintersectApp({ name: "Launchpad", slug: "launchpad" }).addBlock(GoNoGo);

​

Principles

• You describe what something means, and Reintersect decides how it looks. Components take semantic props such as tone="warning" and plain numbers, and Reintersect picks the spacing, the primary button and the layout at each width. Blocks have no CSS, colours or raw HTML.
• Reintersect stores block state. Your app keeps no database for blocks: actions return the next state, and Reintersect validates and saves it.
• Types catch mistakes before you deploy. A destructive action without a confirm dialog, a misspelled choice label, or a block a message action inserts that the app never added are all compile errors.
• Agents can read every block. Each one has a plain-text projection and a required summary, so the agent can read it, quote it and act on it with a member’s approval.