Skip to content

docs(studio): desktop app design — Electron+Effect mirroring t3code#139

Open
Necmttn wants to merge 2 commits into
mainfrom
docs/studio-desktop-design
Open

docs(studio): desktop app design — Electron+Effect mirroring t3code#139
Necmttn wants to merge 2 commits into
mainfrom
docs/studio-desktop-design

Conversation

@Necmttn
Copy link
Copy Markdown
Owner

@Necmttn Necmttn commented Jun 7, 2026

Design doc for wrapping studio as a standalone desktop app.

  • Framework: Electron + Effect, mirroring .references/t3code (evaluated Electrobun, rejected — discards t3code's hardened integration layer).
  • Daemon model C: supervise surreal (:8521) + ax serve (:1738) run from bundled source via bun, to keep live ingest (compiled binary can't host the lmdb/Durable Streams sidecar).
  • macOS-first, standalone (bundles the daemon).
  • Includes t3code salvage map, 4-phase rollout (extract studio → shell → two-process supervisor → packaging), and open risks (surreal bundling+codesign, bun-in-bundle, port/data-dir arbitration).

Build deferred; the implementation plan lands as a follow-up commit on this branch.

Refs #129. Companion to PR #138 (web reachability: studio deploy + daemon PNA CORS).

🤖 Generated with Claude Code

Necmttn and others added 2 commits June 7, 2026 11:36
Captures the approved direction for wrapping studio as a standalone desktop
app: Electron + Effect (mirror .references/t3code), model C daemon (supervise
surreal + bun `ax serve` from source to keep live ingest), macOS-first.

Includes the t3code salvage map (lift ~4k LOC of framework-agnostic Effect,
reuse the ~2k electron/ layer, drop ~3k remote-dev features), a 4-phase rollout
(extract studio -> shell -> two-process supervisor -> packaging), and open
items (surreal bundling+signing, bun-in-bundle, port/data-dir arbitration).

Build deferred; web reachability shipped separately (#129 / PR #138).

Refs #129

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jun 7, 2026

Deploying ax with  Cloudflare Pages  Cloudflare Pages

Latest commit: d3aa509
Status: ✅  Deploy successful!
Preview URL: https://f265dc35.ax-62d.pages.dev
Branch Preview URL: https://docs-studio-desktop-design.ax-62d.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant