Add Cursor Cloud dev environment instructions

[lukasballier]

Summary

Sets up and documents the development environment for the Swirl monorepo so future Cloud Agents can start fast. Adds AGENTS.md with a ## Cursor Cloud specific instructions section capturing non-obvious startup/run caveats.

No application code changed.

Environment verified

• Node 22 + Yarn 1.22 (shipped defaults). Dependencies install via yarn install.
• puppeteer downloads Chromium on first install; cached in ~/.cache/puppeteer and persisted in the snapshot, so later installs are fast no-ops.

Checks run

• yarn build:packages — all 9 library packages build (tokens → icons → components → react/angular/etc.)
• yarn lint — passes
• yarn test --filter='!swirl-docs' — swirl-components 494 tests / 104 suites + bridge pass
• yarn dev — Storybook serves on http://localhost:6006

Hello-world

Loaded Storybook, opened the SwirlButton story, and changed the label control to "Hello World"; the rendered button updated live.

swirl_storybook_button_hello_world.mp4
Button rendered with Hello World label

Notes

• apps/swirl-docs is optional and excluded from CI lint/test; its prebuild/dev/build/tests need GITLAB_ACCESS_TOKEN, GITLAB_FLIP_REPO_ID, and Algolia keys. Its vitest hangs without them, so use yarn test --filter='!swirl-docs' for the library packages.

_{To show artifacts inline, enable in settings.}

  

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
staginggetflipdev	Ready	Preview, Comment	Jun 17, 2026 12:21pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
getflipdev	Ignored		Jun 17, 2026 12:21pm