{
  "schema_version": "1.2.0",
  "canonical": "https://approximated.app/guides/examples/tanstack-start--v1-rc.json",
  "example": {
    "id": "tanstack-start--v1-rc",
    "framework": "TanStack Start",
    "edition": "v1-rc",
    "edition_status": "current",
    "guide": "https://approximated.app/guides/tanstack-start-custom-domains-guide/",
    "version_url": "https://approximated.app/guides/tanstack-start-custom-domains-guide/v1-rc/",
    "source_file": "src/guides/tanstack-start-custom-domains-guide/index.html",
    "edition_source": "src/_partials/guide-editions/tanstack-start/v1-rc.html",
    "upstream_repository": "https://github.com/Approximated-Inc/tanstack-start-custom-domains-example",
    "upstream_exists": true,
    "published": null,
    "prepared_at": "2026-09-09",
    "publication_status": "local_draft",
    "last_reviewed": "2026-09-09",
    "review_scope": "Node 24.20.0: 45 behavior, request-security, local HTTP transport, legacy-SQLite race, and fixture-isolation tests passed; the production build and TypeScript 7.0.2 check completed; the loopback-bound built-server smoke returned Atlas 200, Juniper 200, unknown host 404, localhost control 200, and nonlocal fixture-control host 404. September 9 provider-mode follow-up: 49 tests passed, including four provider-config cases. Typecheck and production build passed. Forced-mock smoke returned the expected 200/200/404 tenant outcomes and control-host restrictions. Root fixed-origin follow-up: an injected conflicting legacy API URL is ignored; 49 tests and build/typecheck passed again.",
    "runtime_test_status": "passed_local",
    "upstream_revision": "07800c6b9e6d227b61e177ae049172dc54525113",
    "tested_versions": {
      "node": "24.20.0",
      "npm": "11.19.0",
      "@tanstack/react-start": "1.168.50",
      "@tanstack/react-router": "1.170.33",
      "react": "19.2.8",
      "react-dom": "19.2.8",
      "vite": "8.2.2",
      "@vitejs/plugin-react": "6.1.1",
      "nitro": "3.0.260903-beta",
      "typescript": "7.0.2",
      "zod": "4.5.4",
      "tsx": "4.23.13"
    },
    "test_commands": [
      "npm ci",
      "npm test",
      "npm run build",
      "npm run seed",
      "PORT=3082 npm start",
      "npm run smoke"
    ],
    "api_contract_revision": "99f0de6b74f4a88a7c5674d86c852036f22dcd13",
    "api_paths": [
      "/api/vhosts",
      "/api/vhosts/{id}"
    ],
    "not_tested": [
      "Live Approximated API mutation",
      "Live customer DNS propagation",
      "Live TLS issuance and HTTPS routing",
      "Browser-driven control-form interaction",
      "Deployment or production runtime",
      "The provider-independent walkthrough snippets are illustrative; companion runtime results do not verify every guide snippet."
    ],
    "direct_resource": "https://approximated.app/guides/examples/tanstack-start--v1-rc.json",
    "snippet_count": 12,
    "snippets": [
      {
        "id": "tanstack-start--v1-rc--snippet-1-typescript",
        "language": "typescript",
        "sha256": "2c2d6ff5f442f4b0c4b188745644263cdc9c3c55c2f96274ad8cfe6c853ef5ae"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-2-typescript",
        "language": "typescript",
        "sha256": "c12005961f8cb095496d8c9dcdd73d27b9e0fa4016e9f187b0369464c0732a56"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-3-typescript",
        "language": "typescript",
        "sha256": "f8655bc188cc8e1374a01cf8c5a8344c26bd8b3e24b7ab22cb5212bd984c2845"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-4-bash",
        "language": "bash",
        "sha256": "db422727aad030fd0ffa1509a34ecfb55bdfe2527939bf12f03ea937eaa5006f"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-5-sql",
        "language": "sql",
        "sha256": "7a7101d1b316ba4e1426c912de8157e8755e2321a35dc1b004dcf056826eec04"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-6-typescript",
        "language": "typescript",
        "sha256": "f19bad29586ce68cec19818f629581fda49036f5c930cd1de1a5dd2cc308a5da"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-7-bash",
        "language": "bash",
        "sha256": "b575ebf89c5d2e0ab93e02f10d21bb60d5d0f098ac4ec73b25d5fea91e568939"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-8-typescript",
        "language": "typescript",
        "sha256": "412f46fd2303c2cd83b4686847449b7ec75fa948cec6fc52397dd556f0abb5ea"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-9-typescript",
        "language": "typescript",
        "sha256": "5b96b050c86473f3b715ea8ff23beac43240c4abd404b1ebd046327679e55aff"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-10-typescript",
        "language": "typescript",
        "sha256": "7513d9a8e4c1da19a5acb9bddafcf4e350ae1c022964224ba9972416376f1f66"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-11-typescript",
        "language": "typescript",
        "sha256": "b6c03d67ba63d6680430115fbecde1fb5d78a5dd5a72621214a0a1c00f07b784"
      },
      {
        "id": "tanstack-start--v1-rc--snippet-12-bash",
        "language": "bash",
        "sha256": "d01e8beabce77cc5f73696ddd6265b4cb6913d671e9754bfb00a4687bec2200d"
      }
    ],
    "sources": [
      {
        "url": "https://tanstack.com/start/latest/docs/framework/react/overview",
        "title": "TanStack Start overview"
      },
      {
        "url": "https://tanstack.com/start/latest/docs/framework/react/build-from-scratch",
        "title": "Build a TanStack Start project from scratch"
      },
      {
        "url": "https://tanstack.com/start/latest/docs/framework/react/guide/server-functions",
        "title": "TanStack Start server functions"
      },
      {
        "url": "https://tanstack.com/start/latest/docs/framework/react/guide/authentication-server-primitives",
        "title": "TanStack Start authentication server primitives"
      },
      {
        "url": "https://www.npmjs.com/package/@tanstack/react-start",
        "title": "@tanstack/react-start on npm"
      },
      {
        "url": "https://nodejs.org/en/about/previous-releases",
        "title": "Node.js releases"
      },
      {
        "url": "https://approximated.app/openapi.yaml",
        "title": "Approximated public OpenAPI contract"
      },
      {
        "url": "https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html",
        "title": "A, AAAA, and CNAME records and apex restrictions"
      },
      {
        "url": "https://developers.cloudflare.com/dns/cname-flattening/",
        "title": "Provider-specific CNAME flattening at the apex"
      },
      {
        "url": "https://approximated.app/docs/#how-approximated-works",
        "title": "Approximated routing, certificates, and dedicated IPv4"
      },
      {
        "url": "https://approximated.app/docs/#edge-verify",
        "title": "Form bot protection with Edge Verify"
      },
      {
        "url": "https://approximated.app/docs/#edge-sequences",
        "title": "Request rules and rate limiting with Edge Sequences"
      },
      {
        "url": "https://approximated.app/docs/#dns-widget",
        "title": "DNS onboarding widget and provider-specific support"
      },
      {
        "url": "https://approximated.app/docs/#webhook-events-virtual-host-monitor-updated",
        "title": "Domain monitoring status webhooks"
      }
    ],
    "walkthrough": {
      "provider_independent": true,
      "optional_integration_anchor": "bonus-approximated",
      "code_scope": "Main walkthrough snippets illustrate adding custom domains to an existing app. They are not a complete standalone application or a copy of the companion implementation.",
      "runtime_verification_scope": "Recorded runtime versions, commands, and results apply to the companion repository implementation. They do not imply that every illustrative guide snippet was executed.",
      "domain_connection_policy": {
        "txt_challenge_required": false,
        "dns_check_in_main": "A brief recommendation to check that DNS points directly or indirectly to the app or its receiving service.",
        "automated_dns_checks": "Explained in the optional Approximated bonus, alongside HTTPS readiness."
      }
    },
    "companion_provider_mode": {
      "default": "auto",
      "api_key_environment_variable": "APPROXIMATED_API_KEY",
      "without_key": "local mock",
      "with_key": "real Approximated API at https://cloud.approximated.app",
      "explicit_mock_override": "APPROXIMATED_MODE=mock",
      "verification": {
        "date": "2026-09-09",
        "summary": "49 tests passed, including four provider-config cases. Typecheck and production build passed. Forced-mock smoke returned the expected 200/200/404 tenant outcomes and control-host restrictions. Root review also verified that a conflicting legacy API URL is ignored; all 49 tests and build/typecheck passed again after that correction.",
        "live_api_used": false
      }
    },
    "publication_evidence": {
      "type": "public_companion_git_tag",
      "published_at": "2026-09-09",
      "repository": "https://github.com/Approximated-Inc/tanstack-start-custom-domains-example",
      "revision": "07800c6b9e6d227b61e177ae049172dc54525113",
      "tag": "guide-tanstack-start1-rc-r1",
      "tag_url": "https://github.com/Approximated-Inc/tanstack-start-custom-domains-example/tree/guide-tanstack-start1-rc-r1",
      "anonymous_clone_verified_at": "2026-09-09",
      "scope": "Companion source publication and anonymous HTTPS clone verified. This does not establish guide deployment or live API, DNS, or HTTPS acceptance."
    }
  }
}