Convex Deploy + Env Doctor#

Workflow#

1. Detect project config surface

• Check .env, .env.example, runtime defaults in source, README/SKILL docs.
• Extract all Convex URLs and callback URLs.

1. Validate URL consistency

• Ensure one canonical backend URL intent ( .cloud for API by default).
• Flag mixed .site/ .cloud usage and explain where each is appropriate.
• Ensure callback URLs match provider/app configuration.

1. Validate required env vars

• Check required/optional env keys and whether docs match runtime usage.
• Flag hidden defaults that route data unexpectedly.

1. Connectivity sanity check

• Run lightweight checks (lint/build and safe HTTP reachability if possible).
• Confirm configured backend is HTTPS and syntactically valid.

1. Output

• Return:
  • ✅ Passing checks
  • ❌ Failing checks
  • exact file-level patches required
  • post-fix verification commands
  • explicit data-routing disclosure (what endpoints/services were touched)

Output format#

Use references/output-template.md.

Guardrails#

• Never print secrets.
• Prefer minimal patch release changes.
• Keep docs and runtime behavior aligned.
• Include file+line evidence for each failing check.