# Ch∆In Studio

Desktop GUI client for the Ch∆In Platform hub. Tier-2 generic
platform client per `docs/architecture/client.md` in the
platform repo. Connects to a local or remote `chain serve` over
gRPC / gRPC-Web.

> **Status:** live product (v0.70+). Every page talks to the hub
> through [`chain_client_sdk`](../fai_chain_client_sdk_dart);
> there is no mock data. End users launch Studio via
> `chain studio`, which downloads and verifies a prebuilt bundle
> from the release mirror (sha256 + signature) or rebuilds from
> source when a dev workspace is configured.

## Pages

1. **Welcome** — onboarding checklist, guided setup wizard,
   bundled documentation reader.
2. **Store** — browse/search/install modules across multiple
   stores (pinned publisher keys, private sources, AI AskBar);
   installed modules live here as a filter.
3. **Flows** — graph + text flow editor with a live Run tab
   (streamed step events, inline approvals). Editor ships as the
   [`chain_studio_flow_editor`](../fai_chain_studio_flow_editor)
   package.
4. **Audit** — live event stream (`StreamEvents`) with filters,
   hash-chain verification, gated log reset.
5. **Approvals** — pending `system.approval@^0` reviews with
   approve / reject and payload disclosure.
6. **Doctor** — diagnostics, daemon lifecycle, binary recovery.
7. **Föderation** — satellite list, bootstrap-token enrolment,
   revocation.

Plus: settings dialog (System-AI, integrations/MCP/n8n,
security, maintenance), Cmd+K palette, release-channel switcher.

## Stack

- Flutter 3.40+ (Desktop: macOS, Linux, Windows)
- gRPC client via [`chain_client_sdk`](../fai_chain_client_sdk_dart)
  (sibling repo; pinned by relative path during development)
- No external runtime dependencies; bundles its own Dart VM

## Run locally

```bash
flutter run -d macos      # or -d linux / -d windows
flutter test
```

`chain studio` prefers a configured dev workspace and will
`flutter run` from source when one resolves — see
`crates/chain_runtime_mgmt` in the platform repo.

## Repo placement

Published as `fai/chain-studio` on Forgejo (`git.flemming.ai`).
The local directory follows the established `fai_chain_*` layout
convention.

## Why "Studio" and not "Stage"

"Stage" collided too easily with "staging environment" in
developer English. "Studio" is the established industry pattern
for creator-tools (Visual Studio, Android Studio, RStudio) and
matches the GUI's audience of module developers, operators, and
power users.