Skip to content

Add AGENTS.md with Cursor Cloud development environment setup#4

Draft
JoDavidsson wants to merge 1 commit intomainfrom
cursor/development-environment-setup-4fa4
Draft

Add AGENTS.md with Cursor Cloud development environment setup#4
JoDavidsson wants to merge 1 commit intomainfrom
cursor/development-environment-setup-4fa4

Conversation

@JoDavidsson
Copy link
Copy Markdown
Owner

Summary

Adds AGENTS.md with Cursor Cloud-specific development instructions for future cloud agents.

What's included

  • Architecture overview: Documents the three main services (Firebase Emulators, Flutter Web App, Supply Engine) with their tech stacks and ports
  • Service startup order: Emulators → sample data ingestion → Flutter web server
  • Gotchas and caveats: Headless Flutter web-server device, Node version mismatch warning, Flutter analyze pre-existing warnings, emulator data persistence, virtualenv detection, Chrome executable path
  • Testing commands: Jest, TypeScript type-checking, Flutter analyze, API smoke test, integration tests

Environment setup verified

Check Status
Firebase Emulators (Firestore + Functions + Auth) ✅ All emulators ready
Sample data ingestion (60 items) ✅ Succeeded
API smoke test (session + deck) ✅ Passed
Jest tests (86 tests) ✅ All passed
TypeScript type check ✅ Clean
Flutter analyze ✅ Info/warnings only (pre-existing)
Flutter web app (localhost:8080) ✅ Running
Interactive demo (swipe, like, view likes) ✅ Working
Open in Web Open in Cursor 

- Document architecture overview (Firebase Emulators, Flutter Web, Supply Engine)
- Include service startup order and commands
- List environment gotchas (headless Flutter, Node version, analyze warnings)
- Document testing commands (Jest, TypeScript, Flutter analyze, smoke test)

Co-authored-by: JoDavidsson <JoDavidsson@users.noreply.github.com>
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.

2 participants