SPB Git

spb/zyquo-cloud-web

Public MIT

Zyquo Cloud Web — every cloud model, one beautiful chat, entirely in your browser.

2.1 KB

# Zyquo Cloud Web — Build Plan & Phase Log

Strict phase order 0 → 8. Each phase gets a checklist here, checked off as work lands, plus a 3–5 line summary at its checkpoint.


# Phase 0 — Research + Zyquo Cloud study

  • Locate native Zyquo Cloud repo (~/Desktop/zyquo-cloud)
  • Study provider layer (ProviderID, ProviderRegistry, OpenAICompatibleClient, AnthropicClient, StreamingService/SSEParser, ProviderProtocol)
  • Study AIModel / capabilities / pricing / ParameterSupport model
  • Study ZyquoTheme design tokens
  • Extract complete model catalog (170 models, 12 providers — port from ModelCatalogData.swift, NOT the drifted catalog-summary.md)
  • Study native UX (views, model picker, personas, prompt library, brand glyph) → docs/NATIVE-UX.md
  • Empirical CORS probes, all 12 providers (preflight + real POST with Origin)
  • Anthropic browser header confirmed (anthropic-dangerous-direct-browser-access: true)
  • Web research: documented CORS stance per provider (cited in CORS-MATRIX)
  • Write docs/CORS-MATRIX.md
  • Write docs/PROVIDER-REUSE.md

Phase 0 summary. Native repo studied end-to-end: only two wire formats (OpenAI chat/completions ×11 incl. Gemini-compat; Anthropic Messages ×1), one SSE parser, 170-model catalog, ZyquoTheme tokens extracted. Empirical CORS probes with real keys: all 12 providers callable directly from the browser (Anthropic needs anthropic-dangerous-direct-browser-access: true); documented stances researched and cited. Proxy/Zyquo Router override still ships since only Anthropic documents CORS officially. Gate satisfied: PROVIDER-REUSE.md + CORS-MATRIX.md complete.


# Phase 1 — Project setup (React + TS + Vite) — pending

# Phase 2 — Architecture + browser provider layer — pending

# Phase 3 — Local persistence — pending

# Phase 4 — Design system & UI — pending

# Phase 5 — Brand assets — pending

# Phase 6 — Features — pending

# Phase 7 — Verification — pending

# Phase 8 — Build & deployment — pending

Files · e17a7df75e121563dfabff122b52b37b02335fe6
Menu

Theme