{
  "slug": "eas-integrations-convex-connect-saves-the-convex-url-as-an-eas-environment-varia-d0e45c04684a",
  "title": "eas integrations:convex:connect saves the Convex URL as an EAS environment variable",
  "tools": [
    "eas"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-05-12T12:22:30.000Z",
  "announced_at": "2026-05-12T12:22:30.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When connecting a Convex project to an Expo project linked to EAS, run `eas integrations:convex:connect` to save `EXPO_PUBLIC_CONVEX_URL` as an EAS environment variable. If it already exists, follow the command’s prompt to avoid an accidental rewrite.",
    "examples": [
      "eas integrations:convex:connect",
      "eas integrations:convex:connect --region aws-us-east-1 --team-name \"<team-name>\" --project-name \"<project-name>\""
    ],
    "gotchas": [
      "Version: v18.12.0",
      "--region <region>: Convex deployment region; documented options include `aws-us-east-1` and `aws-eu-west-1`.",
      "--team-name <team-name>: Name for the new Convex team; defaults to the EAS account name.",
      "--project-name <project-name>: Name for the Convex project; defaults to the app slug.",
      "--non-interactive: Runs the command in non-interactive mode.",
      "Prerequisite: An Expo account, EAS CLI installed, and an Expo project linked to EAS with `eas init`.",
      "If the environment variable already exists, the command prompts the user to prevent accidental rewrites.",
      "Docs conflict: Current Expo documentation says the command creates or updates `EXPO_PUBLIC_CONVEX_URL` for production, preview, and development environments. The v18.12.0 release note says an existing variable triggers a prompt to prevent accidental rewrites; the current docs do not describe that prompt."
    ]
  },
  "why_it_matters": "When connecting a Convex project for EAS deployments, save the Convex URL as an EAS environment variable.",
  "before": "The Expo Convex guide previously instructed users to set the EAS environment variable manually; the release note says this integration automates that step.",
  "sources": [
    "https://github.com/expo/eas-cli/releases/tag/v18.12.0",
    "https://github.com/expo/eas-cli/pull/3685",
    "https://docs.expo.dev/guides/using-convex/",
    "https://github.com/expo/eas-cli"
  ],
  "rank": 0.94023,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-c6e173b388cf876e-0:gate",
    "evidence_hash": "58160e0a8dcc869612cc981bc94f9fa8a57204357b8cdc92f13c7c31601d3f22"
  },
  "review": {
    "draft_hash": "3cd923a4330915d200f483823fd36e327698a3786a25d74cbe7c54bf54da82a2",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.72 (>= 0.6 needed)."
  }
}