Four TypeScript packages sit under the apps, in frontend/packages/.

@seed-hypermedia/client, the SDK. It has no framework dependency and is published to npm. It holds Hypermedia ids and types, blob creation and signing, CBOR, the HTTP client for the Seed API, markdown conversion, the query grammar, key files and vault helpers, and the Hypermedia Schemas engine. Every app uses it, and so do the CLI, the vault and the agents service.

@shm/shared, the app layer: generated gRPC clients, the typed API router and its HTTP server adapter, the universal client abstraction, React Query models, routes and translations. It is not published.

@shm/ui, the React component library, page components, and the shared agents client and models used by desktop, web and mobile. Its reusable buttons, form controls, dialogs, logo and theme can be built as a standalone npm package for services such as SeedHost. Application-specific components and private workspace dependencies stay inside the monorepo; see the package build and release instructions. The Publish UI package workflow validates changes on pull requests and main; an explicit version-confirmed run on main publishes the tested tarball to npm. Publish the package before updating and deploying SeedHost's locked dependency.

@shm/editor, the block editor, a BlockNote fork on TipTap and ProseMirror, with a server-side renderer.

The dependency direction is client, then shared, then ui, then editor. The vault and the agents service consume client and shared through Bun file: dependencies, which copy the packages at install time. A watcher script reinstalls them during development.

Web and desktop use the same content embed components in documents, comments, and discussion quotes. The host owns editing controls and navigation services. It must not supply a different body renderer or override embed typography.

@shm/ui/embed-views loads resources and resolves versions and routes. Card, Link, and Comments display modes retain their existing shared components.

@shm/ui/content-embed owns block selection, fragment selection, expansion state, and author placement. A document fragment expands to its block. A comment fragment expands to the whole comment. A source or range change resets expansion.

@shm/ui/embed-wrapper owns the source action, green rule, and caret control. Links within the content remain separate from the source link. QuotedDocBlock uses the same presentation with source navigation disabled.

@shm/editor/readonly-viewer owns block conversion, highlights, content typography, gallery behavior, and the browser/server rendering contract. EmbedEditorView is a compatibility adapter. The shared context avoids a UI-to-editor dependency. Browser and server implementations both limit nested embed depth.

@shm/ui/account-avatar owns compact and regular author identity. Inline profile mentions share the name primitive and retain their inline link behavior. An account home document remains a document card; it is not a separate profile-card type.

Full document and comment typography are intentional content variants. Collapsed text block quotes and fragments use plain text with the same small text style in every host. Expansion restores the source formatting without changing the stored content. Image and video block embeds open their source; previews preserve aspect ratio, have a 240 px media height limit, and use half the available width (up to 400 px) when their container is at least 480 px wide. Narrower containers use the available width, still capped at 400 px. External video embeds show a static play preview rather than loading a player. Renderer roots isolate typography from surrounding comment styles. This isolation uses CSS @scope, supported by Chrome 118+, Safari 17.4+, and Firefox 146+.

For a repeatable visual review, run direnv exec . node frontend/packages/editor/e2e/capture-embed-gallery.mjs. It builds production components with fixed resource data and writes an interactive HTML file, screenshots, and browser check results to an OS temporary directory. It does not start a server or replace tests in the running web and desktop apps.

A daemon started on its own, without the desktop app, defaults to 55000, 55001 and 55002. Hosted sites run their daemon on 56000 behind a reverse proxy.

Building on Hypermedia, for using these programs from your own code.

Self-hosting, for running a site.

Contributing, for developing them.

The web API, the Seed API most of these programs speak.

Seed Agents, what the agents service runs.

The protocol, what the daemon implements.

A custom HTML page is not a component but a kind of document: one whose html metadata names a UnixFS folder that the desktop opens as a sandboxed HTML page.