Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
Design frames
Avibe's UI designs live here. A frame is a static React render of one surface in one state, built from the product's own components, tokens, assets, and copy, so a design and the shipped UI cannot drift apart. Frames are reviewed and merged like code. The design system and its decisions: docs/plans/design-frames.md.
Layout
frames/<area>/<name>.design.tsx: one file per surface; it default-exportsframes([...]), one frame per state. A frame id is<area>/<name>/<state>.kit/: components a design proposes that are not shipped yet. They use only product tokens (Tailwind classes fromsrc/index.css), assets, andsrc/components/uiprimitives.shell/: the providers frames render in (DesignShell), fixture builders (fixtures.ts), the fixed clock, frame-local Web Storage, and the network stub.
Rules
- Draw shipped surfaces with the shipped component (
@/components/...) and fixtures; never redraw them. - Draw what does not exist yet in
kit/. When it ships, the frame switches to the shipped component, the kit copy is deleted, and the status becomesshipped. - Frames hold no logic: no handlers, no effects, no fetching. State comes from fixtures (
WorkbenchFixtures): a provider that reads the API gets its response fromfixtures.apior a typed fixture field, a remembered preference comes fromfixtures.storage, and a deep link a component reads from the document URL comes fromfixtures.search. Add a fixture field rather than mocking inside a frame. - Tokens only: no raw colors, sizes, or shadows that
src/index.cssdoes not define. Add a token there if one is missing. - Each frame states its size, its themes (default both), and its status:
proposed(being designed),approved(signed off, ready to build), orshipped(renders shipped components only). A proposal becomesapprovedin the PR the owner approves. - Kit copy is draft copy and may be written inline; it moves to
src/i18nwhen the component ships. - When a shipped component mixes data hooks and markup, draw it whole; to redesign part of it, prefer splitting it into a view (props only) and a container, then draw the view.
- Size a frame to include any popover, menu, or card it shows; set
hoverto capture a hover state, andwaitwhen a read starts on a timer (a debounced search). - Code that implements a design names its frame id (
ui/design: sidebar/bots/three), not a description of a drawing.
Loop
npm run design: the canvas with every frame in both themes, hot-reloading.npm run design:shot -- <id prefix>: PNGs indesign/.shots/<id>.<theme>.png(2x); read them to check your work. One JSON line per shot lists API paths the frame touched without a fixture (unfixtured) and console errors; any error exits 1. CI runs it for every frame.npm run typecheck:design: frames type-check against the product's current props, so a product change that breaks a frame fails CI.npm run design:build -- --out <dir>: the canvas as static files.
Presenting a design
Show designs in your own Session's Show Page, next to your explanation:
npm run design:export -- <id prefix>copies the live canvas, a screenshot of each frame, andframes.jsonintopublic/design/of this Session's Show Page, and writessrc/design/DesignFrame.tsxthere.- In a page:
import { DesignFrame } from "../design/DesignFrame", then<DesignFrame id="sidebar/bots/three" />. Each frame runs the real components in an iframe (crisp, scalable, hover and popovers work) and links to its screenshot. - While the Show Page's annotation is on, each frame is drawn as its screenshot so the overlay can reach it; an annotation names the frame (
设计帧 <id>) and theme. Read it back to the frame file before you change anything.
The repository is the source: never edit designs in a Show Page.