Skip to content

ccdwyer/workflow-boards-plugin

Repository files navigation

Workflow Boards — t3code plugin

An installable t3code plugin that adds workflow boards (state-machine boards, tickets, agent step pipelines, work-source sync, webhooks) to the app.

  • server/ — the server plugin (RPC handlers, workflow engine, daemons)
  • web/ — the web bundle (board UI, registered route + sidebar section)
  • contracts/— shared workflow/outbound/work-source schemas
  • scripts/build.mjs — builds the server + web bundles into a .tgz + marketplace.json

Building

The plugin builds against the t3code plugin SDK (@t3tools/plugin-sdk, @t3tools/plugin-sdk-web, @t3tools/contracts, @t3tools/shared). The web bundle externalises them so it shares the host's singletons at runtime; the server bundle bundles contracts + shared.

Until those packages are published, they are linked from a local t3code checkout that has the plugin-system branch:

pnpm install                                   # third-party + dev deps
T3CODE_ROOT=/path/to/t3code pnpm link:t3code   # symlink @t3tools/* from the checkout
                                               # (defaults to ../t3code-plugin-system)
pnpm build                                     # -> dist/workflow-boards-<v>.tgz + marketplace.json

pnpm build produces the server + web bundles and the plugin's own compiled CSS (web/index.css, declared via manifest.entries.styles). The host build only scans host source, so the plugin ships its own Tailwind CSS — the build reuses the host @theme from the checkout so colours resolve to the host's runtime CSS variables. Re-run pnpm link:t3code after any pnpm install (it wipes the symlinks). Once the SDK is published, drop the link step and add the published versions as normal deps.

Distribution

Build the .tgz + marketplace.json, host them, and install via the t3code plugin marketplace.

About

Example installable t3code plugin: a board-as-state-machine workflow engine (46 RPC methods) built entirely on the t3code plugin capability APIs.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages