{"adoption": {"forks": 187, "observed_at": "2026-08-28T04:06:53.338337+00:00", "stars": 2458}, "canonical_url": "https://ross.abutalabs.com/products/graphql-design-tutorial", "card": {"archived": false, "artifact_type": "learning-resource", "description": null, "domain": ["apis", "web-development", "tutorials", "documentation"], "enriched": true, "function": ["documentation", "api-framework", "graphql"], "health_score": 22, "homepage": null, "language": null, "license": "MIT", "license_family": "permissive", "maturity": "maintenance", "member_repos": ["Shopify/graphql-design-tutorial"], "name": "Shopify/graphql-design-tutorial", "platform": [], "pushed_at": "2025-01-23T15:27:15+00:00", "repo": "Shopify/graphql-design-tutorial", "stars": 2458, "tags": ["graphql-schema-design", "api-design-guidelines", "tutorial"], "topics": [], "urls": [], "use_cases": ["learn how to design a GraphQL schema", "best practices for designing GraphQL APIs", "guidelines for evolving production GraphQL schemas", "naming conventions for GraphQL types and fields", "deciding between interfaces and unions in GraphQL", "designing pagination for GraphQL APIs"], "what_it_is": "A public version of Shopify's internal GraphQL API design tutorial, based on lessons from evolving production schemas over years. It provides design guidelines and best practices for creating GraphQL APIs.", "when_to_avoid": ["you need executable code, libraries, or tooling rather than written guidance", "you need rules that apply universally without exceptions", "you need an up-to-date specification rather than opinionated guidelines"], "when_to_choose": ["you are building a new GraphQL API and want battle-tested design guidelines", "you want to review or standardize schema design conventions across a team", "you are learning GraphQL schema design from real production experience"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/graphql-design-tutorial", "repo": "Shopify/graphql-design-tutorial", "role": "main", "score": 34}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:06:53.338337+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T02:29:22.600090+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3a76645aacb73ce2bc5f6114d245defb12bb9a9997ae3264b90490dcdc5cc410", "fetched_at": "2026-08-28T04:06:53.338337+00:00", "kind": "readme", "missing": false, "url": "https://github.com/Shopify/graphql-design-tutorial"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 3, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": ["no_releases"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2907, "days_push": 587, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 34, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}