Set up Cursor Cloud dev environment (docs + update script)

[erikconnect]

Summary

Sets up and verifies the development environment for the Velora monorepo (pnpm + Turborepo, CSS-first design system). No application code changed.

• Added a root AGENTS.md with a ## Cursor Cloud specific instructions section documenting non-obvious startup/run caveats (ignored build-script warning is safe, service ports, verify:contract runs a full build, no DB/secrets needed).
• Configured the startup update script: pnpm install --frozen-lockfile.

Environment verification

Node 22 / pnpm 10.33 are already present in the VM. Verified end-to-end:

• pnpm install --frozen-lockfile — installs cleanly (esbuild/sharp build-script warning is non-blocking).
• pnpm build — full Turborepo build (@velora/css, showcase, docs) succeeds.
• pnpm verify:contract — CSS sync + vl-* contract checks pass (0 issues across 49 pages).
• pnpm --filter @velora/compiler test (8 pass) and pnpm --filter showcase test:library (10 pass).
• pnpm dev → showcase (Vite) on :5173 and pnpm dev:docs → docs (Astro) on :4321, both HTTP 200.

Hello-world proof

Drove the running showcase in a browser: loaded the homepage, opened the interactive Scene Creator tool, added a scene, ran the Layout Wizard → "Generate Layout" (which produced a populated "Product Hero" scene), and toggled the color theme dark→light.

velora_scene_creator_demo.mp4

Velora homepage
Generated scene via Layout Wizard
Light theme applied

_{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)
velora-showcase	Ready	Preview, Comment	Jul 4, 2026 2:09am

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.