Skip to content

Phone: wear the Conch iOS design's look - #251

Merged
Amitgb14 merged 13 commits into
masterfrom
conch/conch-web-has-this-style
Nov 16, 2026
Merged

Amitgb14 merged 13 commits into
masterfrom
conch/conch-web-has-this-style

Conversation

@Amitgb14

Copy link
Copy Markdown
Owner

conch web's phone app takes the style of the Conch iOS mock (https://claude.ai/artifact/VoeJYyGDhXpWZhBAx5fZg7):

  • The mock's dark and light palettes: near-black / off-white neutrals, one orange accent, amber for an agent that needs you, tinted state pills with a dot.
  • A bold sans title instead of the serif (large on Agents, Watch, Machines, Settings); monospace subtitles and branches. Inter / JetBrains Mono where installed, the system's otherwise — the page loads nothing from another site.
  • Filters as a segmented track, round bordered header buttons (new in accent), the amber waiting card, drawn tab-bar icons instead of text glyphs.
  • An agent's screen stays dark in both schemes — its colours are chosen for one.
  • Light uses the design's text accent #a84c14 for fills: white on its #b9561b reads 3.9:1.
  • theme-color metas and the manifest follow; the service worker cache is renamed so phones pick it up.
  • Website phone screenshots regenerated with web/scripts/phone-capture.

Tests

  • New TestUIStyleFollowsTheDesign (fails before, passes after): pins the palette, every text colour pair ≥ 4.5:1 in both schemes, theme colours, tab icons.
  • Source budget 176 → 180 KiB for the 2.2 KB added (comment says why).
  • make lint clean; internal/phone passes. Full race suite: everything passed except TestTicketCheckDeadline (internal/server, untouched here), which timed out at load average ~30 and passed 5/5 on its own.
  • Checked by eye in dark mode via headless Chrome; light mode only through the contrast checks.

🤖 Generated with Claude Code

Amitgb14 and others added 13 commits November 12, 2026 23:22
A Compared page in the docs: one table across the four tools (shape,
platforms, persistence, agents, state, sessions, git and PRs, the
autopilot, MCP and scoping, remote machines, sandboxes, phone), then
when another tool is the better choice and when conch is. Dated, from
each project's own docs, since the others ship weekly. Linked from the
introduction's "Is conch for you?".

Tests: every sidebar entry has a page.mdx, and the compare page lists
all four tools, says when it was written, and has no row whose cells
would shift under the wrong column.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The comparison page named herdr, T3 Code and Orca row by row, which
dates quickly and reads as a claim about other projects. In its place,
Why conch: what conch does that other agent orchestrators leave to you
— the server-side autopilot, reloads that keep agents running, OSC 7501,
scoped agent-to-agent work, sandboxes as machines, cross-agent
sessions, a phone without a third party's server, the terminal first,
and the brain — each linking to the page that explains it.

Test: the sidebar and introduction point at /docs/why and not at the
removed /docs/compare, and every point on the page links to its docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… task's flow, agent states

Built from the site's own type and colours rather than pictures, so they
stay sharp, follow the light and dark themes, and need no retaking when
the TUI changes. TuiShot puts a captured TUI screen in a docs page, and
the landing page's architecture drawing is now available to pages too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…tures

The introduction opens with the TUI on a project and a What's new grid
(Conch.app's workbench, a branch's changes, browser tabs, files and Edit
with Agent, the server's autopilot, phones per device), draws how conch
fits together and the agent states, lists Devin with the other supported
agents, and ends on cards rather than a list. Why conch gets a summary
grid, the autopilot's loop, a section on the desktop app with its
screenshots, the phone, and the architecture; Tensorlake is left out of
it, since making a Tensorlake sandbox is hidden. Tasks draws a task's way
from prompt to merge, and Agents the states and how they are known.

Tests: every component a docs page uses is registered for MDX, every
screenshot and TUI screen it names exists, and these pages carry their
pictures.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The guides had grown to 88k words (the interface page alone 16k, the Mac
app 14k) and went unread; people look at the pictures and a line. Each
guide page is now a picture, one heading per feature, a sentence or two
on what it does and how to use it — key, command or menu — and a link
to the reference for the rest. The reference pages (keys, command line,
configuration, protocol) stay whole, since they are looked things up in.
Headings other pages link to were kept; three links that pointed at
headings no longer there (interface#workspaces, sessions#sharing-with-
another-agent, agents#two-tiers) now land. Tensorlake is one line, as
making one is hidden; Conch Cloud is not promoted.

Tests: each guide stays under 700 words of prose with no paragraph over
60, and every link to a docs page — from a page, the sidebar or the
site's components — reaches a page and heading that are there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Conch Cloud and Cloud machine image pages stay but are no longer
linked from the sidebar, and open with how to turn Cloud on. The CLI
page's login, logout, account and cloud sections move to a Conch Cloud
section at its end under the same note; the interface and Mac app pages
say it is off and what a cloud machine somebody has keeps.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Conch Cloud is not enabled in 0.2.0. The test says the sidebar leaves
its two pages out, both pages say it is not enabled, and nothing else on
the site names it but the Command line page's own section about its
commands — so a guide page rewritten later cannot bring it back.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts:
#	web/src/app/docs/agents-together/page.mdx
#	web/src/app/docs/agents/page.mdx
#	web/src/app/docs/cli/page.mdx
#	web/src/app/docs/interface/page.mdx
#	web/src/app/docs/mac-app/page.mdx
#	web/src/app/docs/phone/page.mdx
#	web/src/app/docs/sandboxes/page.mdx
#	web/src/app/docs/sessions/page.mdx
#	web/src/app/docs/tasks/page.mdx
conch web's phone app takes the style of the Conch iOS mock: near-black
and off-white neutrals, one orange accent for what you press, amber for an
agent that needs you, tinted state pills, a bold sans title where there
was a serif (large on the four top views), the filters as a segmented
track, round bordered header buttons, and drawn icons in the tab bar
where there were text glyphs. Faces are Inter and JetBrains Mono where
installed, the system's otherwise — the page loads nothing from another
site. An agent's screen stays dark in both schemes, since its colours
were chosen for one.

Light uses the design's text accent (#a84c14) for fills too: white on its
#b9561b reads 3.9:1. TestUIStyleFollowsTheDesign pins the palette, checks
every text colour pair at 4.5:1 in both schemes, and that the theme
colours and tab icons follow. The source budget goes from 176 to 180 KiB
for the 2.2 KB this adds; the service worker's cache is renamed so a
phone picks the new look up.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Regenerated with web/scripts/phone-capture after the phone app took the
Conch iOS design's style.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Amitgb14
Amitgb14 merged commit 11a9447 into master Nov 16, 2026
6 checks passed
@Amitgb14
Amitgb14 deleted the conch/conch-web-has-this-style branch November 16, 2026 00:13
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