Skip to content

chore: set up cloud dev environment for Convex backend - #8

Open
anamhira47 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-a180
Open

chore: set up cloud dev environment for Convex backend#8
anamhira47 wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-a180

Conversation

@anamhira47

Copy link
Copy Markdown

Summary

Sets up the Cursor Cloud (Linux) development environment for this repo. The iOS app (apps/ios-sweep-alert) cannot be built here (no Xcode / Revyl CLI), so the runnable, testable service in this environment is the Convex TypeScript backend in convex/.

Changes:

  • Add @types/node devDependency so the documented standalone backend typecheck npx tsc -p convex/tsconfig.json --noEmit passes on a fresh clone (the convex/*.ts files reference process.env).
  • Document non-obvious Cursor Cloud setup caveats in AGENTS.md (anonymous local Convex deployment via CONVEX_AGENT_MODE=anonymous, placeholder Auth0 env vars for local deploys, auth-gated functions, and the Universal Links HTTP endpoints).

Update script (run on VM startup): npm install

Verification

Ran end-to-end against a local anonymous Convex deployment (client API on :3210, HTTP actions on :3211):

  • npm install
  • npx tsc -p convex/tsconfig.json --noEmit (backend typecheck)
  • CONVEX_AGENT_MODE=anonymous npx convex dev — local backend downloaded, schema + indexes created, all functions deployed
  • ✅ Hello-world core flow: seeded a user → crew → car → parked session and scheduled a street-cleaning reminder (alertJobs.status = scheduled), then read it back via a query (temporary smoke-test function, since removed)
  • cars:getMyCars correctly enforces auth (Auth required)
  • ✅ Convex HTTP router serves /.well-known/apple-app-site-association and /invite/<token> (Universal Links)

convex_backend_verification.log

Note: real Auth0/APNs credentials and a Revyl API key are still required for full iOS end-to-end validation; those are out of scope for Linux backend dev.

Open in Web Open in Cursor 

- Add @types/node devDependency so the standalone backend typecheck
  (npx tsc -p convex/tsconfig.json --noEmit) passes on a fresh clone
- Document Cursor Cloud Linux setup caveats (anonymous local Convex
  deployment, auth-gated functions, Universal Links endpoints) in AGENTS.md

Co-authored-by: Anam Hira <anam@revyl.ai>
@anamhira47
anamhira47 marked this pull request as ready for review June 28, 2026 05:38
@revyl-dev

revyl-dev Bot commented Jun 28, 2026

Copy link
Copy Markdown

Preview builds for f3a8b72c.

Build Target Status Details Updated (UTC)
SweepAlert Swift (iOS) Ready Open preview View logs 2026-06-28 05:39

Validation

Check Status Details Updated (UTC)
Proof of changes Ready View report 2026-06-28 05:40

What we exercised

We launched the SweepAlert application to verify that the app boots correctly on the device. We then navigated the primary screen to confirm the basic app layout and interactivity are fully operational.

Revyl debug · proof diagnostics (internal)
  • Proof of changespassed · stage: Ready
    • dispatch: submittedscm-adaptive-report_codex-168d-staging (run af3a1d32-b12)
    • device run: 2c7aaa39-646
    • summary: Adaptive proof passed. Revyl exercised the PR flow and validated the result.
    • session

@revyl-dev

revyl-dev Bot commented Jun 28, 2026

Copy link
Copy Markdown

Preview builds for f3a8b72c.

Build Target Status Details Updated (UTC)
SweepAlert Swift (iOS) Building View logs 2026-06-28 05:38

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