Await is a widget workshop for makers of small, thoughtful creations. Start from templates or build from scratch, tune styles with panels, and create iOS widgets with AI-assisted TSX.

This repository is the installable await-widget agent skill and the developer docs source for Await widgets.

• Download Await
• Developer Docs
• Skill Instructions
• Template Project
• Privacy Policy
• Feedback

The wider Await Widget workspace is split by responsibility:

• skills: installable agent skill, widget templates, and docs site source.
• library: gallery/widget files built for Await App download.
• runtime: @await-widget/runtime, the public TypeScript declarations package used for widget type checking.

Install the await-widget skill via npx skills, which works across Claude Code, Codex, Cursor, OpenCode, Gemini CLI, and other agents.

# Project-scoped
npx skills add await-widget/skills

# User-scoped
npx skills add await-widget/skills -g

# Install only to a specific agent
npx skills add await-widget/skills -a claude-code -g

Restart your agent after installing. The skill registers as await-widget and bundles await-widget/SKILL.md plus await-widget/examples/.

Widget projects should install the runtime declarations from npm:

npm install -D @await-widget/runtime typescript

Configure TypeScript to use the Await JSX runtime and declarations:

{
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "await",
    "types": ["@await-widget/runtime"]
  }
}

Import widget components from await:

import { Text } from "await";

function widget() {
  return <Text value="Hello world" />;
}

Await.define({ widget });

git clone https://github.com/await-widget/skills.git
cd skills/await-widget/examples
npm install
npm test

Use the await-widget skill. Read await-widget/SKILL.md first, then read docs/README.md before writing code.

For full guides, API reference, and AI prompt patterns, open Developer Docs.

MIT