# Glance

> Glance is widget infrastructure for live iPhone Home Screen widgets. ChatGPT, Claude, and Cursor keep the intelligence. Glance is the slot, the layout, and ingest.

Documentation is server-rendered HTML at https://glance.cool — fetch it directly. Do not invent component types (`chart`, `webview`). Do not treat ChatGPT Plus or Claude Pro as Glance Pro.

## Start here

- [MCP](https://glance.cool/mcp): Connect ChatGPT, Claude, or Cursor. Public MCP URL `https://glance-api.fly.dev/mcp`. Design skill install (raw SKILL.md, zip, `npx skills add`).
- [Discover](https://glance.cool/discover): Public widgets with Show in Discover on. Custom images and live layouts. Ranked by subscribers. Query `?sort=newest` or `?category=wellness`. Later pages use `?cursor=` and are not indexed — each widget is `https://glance.cool/{slug}`. Unlisted widgets are not listed.
- [Features](https://glance.cool/features): Widget → layout → feed → sources → share, with live plan limits
- [Docs overview](https://glance.cool/docs): Product model and concepts
- [Glance MCP docs](https://glance.cool/docs/mcp): Tools, OAuth vs write key, ingest XOR, full design skill
- [Glance AI](https://glance.cool/docs/glance-ai): In-app Chat. Different from public MCP. Message caps apply only here.

## Design

- [Layout language](https://glance.cool/docs/layout-language): Node shape, style rules, ignored CSS names (`gap` → `spacing`, `textAlign` → `alignment`)
- [Components](https://glance.cool/docs/layout-language/components): All 19 v1 types with bindings and style fields from the registry
- [Golden examples](https://glance.cool/docs/layout-language/examples): Six reference layouts with **full layout + content JSON in page source**
- [Design skill](https://glance.cool/docs/mcp#design-skill): Agent composition rules (same file as `glance://skills/design`)
- [Design skill SKILL.md](https://glance.cool/skills/glance-design/SKILL.md): Raw skill. `npx skills add https://glance.cool/skills/glance-design/SKILL.md`
- [Design skill zip](https://glance.cool/skills/glance-design.zip): Upload in Claude Settings → Skills or ChatGPT Plugins → Skills

## Ingest

Dynamic ingest is XOR — exactly one layout arm, never both.

- Saved layout: `template_id` + `content`. Merges. Every plan. Automations and reuse.
- UI on Demand: `inline_ui` `{ tree, widget_size? }` + `content` (top-level `tree` is the same arm). Full replace. Pro+. No layout row.
- MCP hosts call the `ingest` tool with OAuth. Do not HTTP POST a write key from ChatGPT/Claude.
- Write-key HTTP is for Shortcuts, Zapier, Make, n8n, and your backend.

- [Dynamic ingest API](https://glance.cool/docs/api/dynamic-ingest): Both arms, examples, when not to use UI on Demand
- [Layouts](https://glance.cool/docs/layouts): Saved layout JSON

## Also

- [Connected integrations](https://glance.cool/docs/integrations): Google, GitHub, device sources (Meta coming soon on iOS)
- [Pin to Home Screen](https://glance.cool/docs/pin-widget): Hosts cannot place the widget
- [Legacy webhook API](https://glance.cool/docs/legacy/webhook-api): Summary, Status, Counter, Approval, Custom schemas

## Golden layout files (repo paths)

Each golden has a layout file and a content file in `packages/sdk/goldens/`:

- s1-glance-kpi / s1-glance-kpi-content (small)
- s2-glance-media / s2-glance-media-content (small)
- m1-split-strip / m1-split-strip-content (medium)
- m2-multi-source / m2-multi-source-content (medium)
- l1-app-performance / l1-app-performance-content (large)
- l2-outfit-of-the-day / l2-outfit-of-the-day-content (large)

The golden examples docs page embeds the complete JSON for every example in HTML `<pre>` blocks.

## Legal

- [Privacy Policy](https://glance.cool/privacy)
- [Terms of Service](https://glance.cool/terms)
- [Data Deletion Instructions](https://glance.cool/data-deletion)