Skip to content

docs(adr): Ship one chat UI in v1 and hold the switcher for v2 - #347

Merged
omesser merged 1 commit into
mainfrom
docs/ux-theme-modularity
Sep 5, 2026
Merged

omesser merged 1 commit into
mainfrom
docs/ux-theme-modularity

Conversation

@omesser

@omesser omesser commented Sep 5, 2026 •

Copy link
Copy Markdown
Owner

Why

#339 decided that v1 ships the modern-minimal design plus the seam that makes a design swappable, and that v2 gives the user a switcher.

Your review renamed the concept to chat UI and, in answering the scope question, narrowed it. The only webview windows today are the overlays — build_overlay is the tree's one WebviewWindowBuilder and they all load src/index.html — so src/main.css and src/bubble.js draw the Character's art, not a chat window. The chat surface is a second window, and #17 has yet to build it.

What changed

ADR-0013, plus Chat UI in CONTEXT.md so the word is not coined in the ADR alone.

The seam is src/chat-ui.css and class="chat-ui-minimal" on the chat window's own root — no registry, no settings key, no runtime stylesheet loading. The tokens ship with that window rather than being retrofitted into the overlay, so the speech bubble keeps what #119 gave it. The switcher is an application setting. Settings stays out of scope at your direction, and #349 is withdrawn.

No application code, no stylesheet.

How to verify

Read the ADR. git grep 'look\.css\|look-minimal' returns nothing.

#339 merging is v2's dependency, since two of the three designs live only on that branch. #355 and #348 are updated for the rename.

— Claude Code, on @omesser's behalf.

Comment thread CONTEXT.md Outdated
Harness. #17, ADR-0010.
_Avoid_: Chat window, console, terminal, prompt box

**Look**:

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The context here is just the webview which means just the chat windows, correct? if so the language should not be "look" which might be wrongly attributable to the character's art. let's use "chat UI" instead

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renamed to chat UI throughout. On the question: not correct as stated, and
getting it right narrowed the ADR — so thank you for asking rather than just
saying the word.

The webview today is the overlay, not the chat window. build_overlay is
the only WebviewWindowBuilder in the tree (src-tauri/src/main.rs:553) and
it builds from WebviewUrl::default(), so every window we create loads
src/index.html — whose own comment says main.js builds one sprite and one
bubble per Character Instance. There is one such window per display.
src/main.css and src/bubble.js are that overlay's stylesheet and that
overlay's speech bubble: the webview that draws the Character's art. The chat
surface is a second webview window (ADR-0010: "a Tauri webview window
ai-buddy builds") and it does not exist yet — #17 creates it.

So "just the webview" and "just the chat windows" are currently opposite ends
of the codebase. Your intent was the chat surface, and the ADR as written did
not match it: it put class="look-minimal" on src/index.html and lifted
tokens out of src/main.css and src/bubble.js — the wrong file in all three
places.

Narrowed to match. The visual language governs the chat surface's own
window and stylesheet. Since that surface does not exist yet, the seam is not
retrofitted: the tokens ship with the chat window #17 builds, written
against tokens the first time rather than extracted from anything. The overlay
is untouched — src/main.css and src/bubble.js keep the colours and fonts
they shipped with in #119.

The bubble is out, and that also settles the one open question the ADR was
carrying. It was open because the bubble and the chat surface looked like two
text surfaces in one window sharing one stylesheet. They are not: the bubble is
drawn in the overlay, above the sprite, beside the Character's art. By your own
reasoning for the rename, it belongs to the Character's expression, not to
ai-buddy's chrome.

What the rename touched: the ADR is
docs/adr/0013-one-chat-ui-in-v1-switcher-in-v2.md; the token file is
src/chat-ui.css; the class is .chat-ui-minimal, glob .chat-ui-*; #355 and
#348 are updated. git grep 'look\.css\|look-minimal' is empty.

CONTEXT.md keeps Chat surface and Chat UI as two entries rather than
folding them, because ADR-0013's subject is a design that is named and
swappable independently of the window — fold them and there is nothing for the
switcher to switch between. Each entry's _Avoid_ now rejects the other
reading: "Look" under Chat UI, and "Chat UI (its visual design, not the
window)" under Chat surface. Say the word if you would rather have one
entry.

Rebased onto d9067a86; #336, #338 and #331 all merged cleanly under this.

— Claude Code, on @omesser's behalf.

Records @omesser's decision on #339, narrowed to the chat surface at his
review of #347. Settings is out of scope.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@omesser
omesser force-pushed the docs/ux-theme-modularity branch from 517226b to fe45093 Compare September 5, 2026 14:48
@omesser omesser changed the title docs(adr): Ship one Look in v1 and hold the switcher for v2 docs(adr): Ship one chat UI in v1 and hold the switcher for v2 Sep 5, 2026
@omesser
omesser merged commit 0239f7b into main Sep 5, 2026
3 checks passed
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