# Facet

> Facet is a Mac design app your AI assistant can design in: install it, connect Claude, ChatGPT, Cursor or VS Code in one click, and build screens and component sets from a short JSON language. Every page below has a Markdown twin (the same name ending in .md).

## Get started
- [Facet](index.md): A Mac design app your AI can design in. Install it, connect your assistant in one click, and describe what you want.
- [Install Facet](install.md): Download Facet, drag it to Applications, open it once. Two minutes, no account.
- [Your first design](start.md): Open the sample, ask your AI to finish it, or build a first card yourself from the command line.
- [Connect your AI](connect.md): Let Claude, ChatGPT, Cursor or VS Code design in Facet. One click from the app, or a few lines by hand.
- [The command line](command-line.md): Install the facet command, see what is connected, and use Facet from Terminal and scripts.

## Language
- [The language](language.md): What a build call can contain, how names resolve, and what containers pass down.
- [The loop](loop.md): Build, look, read back with source, change with sync. The fewest calls and tokens per change.
- [Kit](kit.md): Colors, type presets and parts said once, kept with the file and named everywhere after.
- [Layout](layout.md): Rows, columns, grids, stacks and rings; sizes; and placing a layer by words, anchors or angles.
- [Text](text.md): Strings as texts, the font shorthand, presets, what containers pass down, and sentences with components in them.
- [Color](color.md): Kit colors, variables, tints, gradients and modes.
- [Repeat](repeat.md): One node per item of a list, or a count, with the item's fields substituted.
- [Drawing](drawing.md): Circles, lines, arcs, polygons and paths as data, with fills, gradient strokes and dashes.

## Components and behavior
- [Components](components.md): Component sets with variants and properties, layers that belong to some variants, and instances.
- [Behavior](behavior.md): The states a component moves through, the scenarios that decide them, plays and looks, written beside its variants.

## Changing designs
- [Changing designs](update.md): Read a design back with source, change it in place with sync, edit values with modify, replace a set.
- [Checks](checks.md): What every write verifies, the warnings it reports, and expect for what must hold.

## For agents
- [For agents](agents.md): How an agent builds the most with the fewest tokens and round trips, and how to recover from mistakes.
- [Agent card](card.md): The language and the loop on one page, for agents: enough for most builds in a few thousand tokens.

## Help
- [Updates and uninstalling](updates.md): Facet updates itself; uninstall removes the app, its settings and its connections, never your designs.
- [Troubleshooting](troubleshoot.md): What to do when Facet will not open, an assistant cannot find it, or a command is missing.

## Gallery
- [Gallery](gallery.md): Complete designs built with the language, each with its source and token cost.

## Reference
- [Keys](keys.md): Every key a node can carry, with its forms and what it does.
- [Commands](commands.md): Every command with its arguments, flags and an example.
- [Result codes](codes.md): Every warning and error code a reply can carry, and what to do.
- [Font](font.md): The grammar of the font shorthand.
- [Chart](chart.md): The compact behavior format, the full chart format it compiles to, and the commands that read them.

## Optional
- [llms-small.txt](llms-small.txt): the agent card, enough for most builds in a few thousand tokens
- [llms-full.txt](llms-full.txt): every page in one file, examples and their outputs included