Golden Image

About Golden Image

Golden Image is the base Mothership apps are built from. It holds the React app template and SDKs, Python and Node workers, the checker, and a document review example app.

Golden Image's default app, Document Review, running in Mothership.Golden Image's default app, Document Review, running in Mothership.
Golden Image's default app, Document Review, running in Mothership.

What it is

The starting point of a repository that builds one Mothership app. One repository is one app, and by default it is frontend-only. Upload the ZIP make build produces to Mothership and it's an app; nothing to host.

  • Frontend: a React app, with entry.ts keeping the host's mount/unmount contract, a UI kit that takes design tokens (src/ui/) and the Pretendard font, so the same build runs on closed networks.
  • SDKs: @mothership/sdk-core and sdk-react for data, state, files, AI, knowledge, Runtime, connectors and jobs, plus the contract schema (agent-contracts). Contract 1.2.0.
  • Backend (optional): a Python (FastAPI) or Node (TypeScript) worker, only when really needed.
  • Checker: schema validation, Mothership's registration rules and the frontend/backend pairing check (scripts/check.py).
  • Profiles and base updates: create new apps from pinned profiles, and update SDKs and build tools while keeping what app authors changed.

The rule: frontend-only whenever possible

What the Mothership gateway already provides completes most apps. A backend is justified only for:

  1. Wrapping an external API not available as a registered MCP connector (CSP blocks direct fetch from the browser)
  2. Server-side integrations that need secret keys
  3. Heavy computation a browser can't do
  4. A standalone service offering shared capabilities or data to several apps (parts: ["backend"])

The default app: Document Review

The bundled Document Review Workspace is a complete frontend-only workflow.

  1. Upload a private document and queue its extraction. Queued, processing, ready, failed and cancelled states are kept.
  2. Select ready documents and ask. Search is filtered to those documents before ranking, and the answer comes with citations. No evidence, no answer.
  3. Inspect the citations, edit the draft, confirm it, and save a schema-validated reviews record.
  4. Export the approved content and its sources as a text file, or continue with the document-review Runtime profile.
  5. Reopen earlier runs, and resume a pending question or consent.

Next

Esc