docs(agents): add Cursor Cloud dev environment setup instructions

[Bran18]

What & why

Sets up the KindFi development environment for Cursor Cloud and documents the non-obvious caveats discovered while doing so. The only code/docs change is a new ## Cursor Cloud specific instructions section in AGENTS.md; everything else (Bun, Docker, local Supabase, apps/web/.env, seeded data) is environment state, captured via the VM snapshot + update script.

Environment set up

• Bun 1.3.14 (pinned) installed and symlinked onto PATH; bun install restores all workspace deps.
• Docker installed (fuse-overlayfs, containerd-snapshotter disabled, iptables-legacy) to run local Supabase.
• Local Supabase started via bunx supabase start --workdir . (plain supabase start mis-detects the workdir and aborts on email-template content_path).
• apps/web/.env generated with local Supabase keys; schema applied tolerantly + drift patched so the app has real data.

Update script

bun install — minimal, idempotent dependency refresh. One-time system setup (Bun, Docker, Supabase CLI) is captured in the snapshot, not the update script.

Hello-world verified (core crowdfunding flow)

Browsed /projects (3 seeded campaigns), filtered by the Education category (narrowed to 1 result), and opened the Clean Water for Rural Schools detail page — all against the local DB with no errors.

kindfi_project_discovery_clean.mp4

Projects list with three campaigns
Filtered to Education category (1 result)
Clean Water project detail page

Notes / known pre-existing issues (documented in AGENTS.md)

• Committed Supabase migrations don't cleanly build a schema from scratch (RLS policy precedes its table; user_role pending/admin enum values added late; app expects projects.foundation_id + a foundations table that no migration creates).
• Email signup/KYC/passkey flows require external secrets (Resend, Didit) / a WebAuthn authenticator and can't be exercised locally.
• bun run lint and apps/web bun test run but have pre-existing failures (formatting nits; tests that time out on unconfigured Redis/external APIs).

_{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)
kindfi	Ready	Preview, Comment	Jul 1, 2026 2:39am

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 5f3f7787-8509-4831-8614-182c53774fca

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch cursor/setup-dev-environment-96e2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}