Skip to content

Show what you can build on ABX, and that objects can act - #219

Merged
ryley-o merged 2 commits into
mainfrom
docs/what-you-can-build
Nov 12, 2026
Merged

ryley-o merged 2 commits into
mainfrom
docs/what-you-can-build

Conversation

@ryley-o

@ryley-o ryley-o commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Why

Assistants asked what to build with ABX mostly suggest generative art. Our own material also left out ABX's most distinctive feature: objects can act. Integrations were described almost entirely as reads, such as an object reflecting a pool or a treasury. But a hook can launch a token, trade, pay a treasury, or call any contract as a side effect of a mint, transfer, burn, or setting change.

What changes

  • New page: What you can build, first under Use ABX. It covers:
    • "ABX: the X is for anything."
    • An Objects that act section.
    • A starting-points table linking each kind of project to its docs.
    • Live on ABX: real projects grouped by what they do, ending open ("The best ABX idea hasn't been thought of yet.").
    • Prompts to steal, and a short list of limits.
  • Ecosystem integrations guide: a new section, "Read the chain, or act on it", with a trigger → side-effect table. The companion-token paragraph now allows a hook to launch the token.
  • Skill: ecosystem.md gains "Objects can act, not only read" (plus the Contents map that long references need), and tokens.md allows hook-driven launches while keeping launch terms under separate review. Patch changesets for @artblocks/abx-cli.
  • llms.txt, README, docs landing page: the same framing, plus a "Use cases" button.

Where the project list comes from

I read Deployed events from every v2 and v3 ABX factory on Ethereum, Base, Arbitrum, and Robinhood Chain: 93 collections, about 50 real projects after removing tests and rehearsals. Descriptions come from each collection's own onchain metadata and public pages.

Validation

  • pnpm build; pnpm test: 1,738 passed, 0 failed, 12 skipped
  • pnpm check:hygiene
  • site: types:check and next build; built llms.txt inspected; page checked in headless Chrome

🤖 Generated with Claude Code


Note

Low Risk
Documentation and agent-skill reference text only; no contract or runtime behavior changes.

Overview
Adds What you can build as the first Use ABX doc page, positioning ABX beyond generative art with a capability map, shipped examples, stealable prompts, and limits (hooks on code projects only, etc.). site/lib/about.ts extends ABX_LLMS_CONTEXT and exports WHAT_YOU_CAN_BUILD_PATH; the docs home gets a Use cases link, and README, agent-and-skill, and nav meta.json point at the new page.

Docs and the bundled agent skill now stress that integrations read and act: mint/transfer/burn/setting hooks can run same-tx contract calls (swaps, token factory launches, treasury payouts). ecosystem-integrations.mdx, .claude/skills/abx/reference/ecosystem.md, and ecosystem/tokens.md document acting alongside reads, hook constraints, and companion-token launch via hooks. A @artblocks/abx-cli patch changeset records the skill update.

Reviewed by Cursor Bugbot for commit 6edc457. Bugbot is set up for automated code reviews on this repo. Configure here.

Assistants asked what to build with ABX mostly suggest generative art,
because public ABX material says little about other uses. This adds a
canonical, crawlable answer and points the main entry surfaces at it.

- New docs page, first under Use ABX: says plainly that ABX is not only
  for generative art, maps each kind of project (websites and archives
  with ABX FS, apps and games, stateful objects with rules, onchain
  actions, protocol and community integrations, records, datasets, art)
  to the feature and docs that support it, lists shipped projects, gives
  example prompts, and states the limits.
- llms.txt: the summary now names these uses and links the page.
- Docs landing page: a "Use cases" action beside Quickstart.
- README and agent setup page link to the new page.

Validation: site types:check and next build; repo hygiene check; built
llms.txt inspected; landing and new page checked in headless Chrome at
desktop, tablet, and 390px widths.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
abx-docs Ready Ready Preview Nov 12, 2026 8:29pm UTC

Request Review

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Approved. Cursor Bugbot and Cursor Security Agent both completed successfully with no findings that need human review. No applicable approval policy requires additional review.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

"What you can build" now leads with "the X is for anything," lists real
projects found by reading every ABX factory on Ethereum, Arbitrum, and
Robinhood Chain (plus known Base projects), and ends open-ended. Copy is
rewritten to be shorter and more concrete.

The bigger fix is framing. Integrations were described almost entirely as
reads: an object reflecting a pool or a treasury. ABX objects can also
act: configure hooks, transfer hooks, and custom minters can launch a
token, trade, pay a treasury, or call any contract as a side effect of a
mint, transfer, burn, or setting change.

- Docs page: new "Objects that act" section, "Live on ABX" (Position
  Cards, HODL, AB5D, Marfa Light, ABXdoku, Bird Sightings, hollerith,
  Sprite Party, the GenArt Foundation mural, Grid No. 1, coinspace,
  cc0py, and art), more prompts, and a tighter limits list.
- Ecosystem integrations guide: "Read the chain, or act on it" with a
  trigger/effect table; the companion-token paragraph now allows a hook
  to launch the token.
- Skill: ecosystem.md gains "Objects can act, not only read" (and the
  Contents map long references need); tokens.md allows hook-driven
  launches while keeping launch terms under separate review.
- llms.txt summary and README carry the same framing.

Validation: pnpm build; pnpm test (1,738 passed, 12 skipped); repo
hygiene; site types:check and next build; page checked in headless
Chrome.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ryley-o ryley-o changed the title Add a "What you can build" docs page for non-art uses Show what you can build on ABX, and that objects can act Nov 12, 2026
@ryley-o
ryley-o added this pull request to the merge queue Nov 12, 2026
Merged via the queue into main with commit 09d8c5c Nov 12, 2026
14 checks passed
@ryley-o
ryley-o deleted the docs/what-you-can-build branch November 12, 2026 21:15

This branch was successfully deployed

1 active deployment
Preview — 6edc457c Deployed Nov 12, 2026 by vercel[bot]
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