Strawberry-Django

Strawberry-Django takes a very different shape from Graphene: it is type-hint-first, uses schema extensions (not middleware), ships a built-in query optimizer, generates CRUD mutations/filters/pagination from Django models, and is async-native. The references below focus on what is specific to Strawberry, not general GraphQL.

Query Optimization

| Topic | Reference | Use for | | --------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | | DjangoOptimizerExtension | references/optimizer.md | Automatic only/select_related/prefetch_related/annotate from AST, hint fields, custom resolver optimization, edge cases | | N+1 and DataLoaders | references/n-plus-one.md | When the optimizer cannot help, async DataLoader in get_context, priming, combining with the optimizer |

Schema Design

| Topic | Reference | Use for | | ----------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | Types and Fields | references/types-and-fields.md | @strawberry_django.type, auto, computed fields, get_queryset, model_property, enum generation, field descriptions from help_text | | Mutations | references/mutations.md | mutations.create/update/delete, NodeInput, partial inputs, handle_django_errors, custom mutations, transaction atomicity, batch operations | | Filters, Pagination, Relay | references/filters-pagination-relay.md | @strawberry_django.filter, custom filter_field, @strawberry_django.order, offset vs DjangoListConnection vs DjangoCursorConnection, relay.Node and GlobalID |

Security

| Topic | Reference | Use for | | ---------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | Permissions & Security | references/permissions-and-security.md | IsAuthenticated/IsStaff/HasPerm/HasRetvalPerm/HasSourcePerm, django-guardian object-level perms, DisableIntrospection, QueryDepthLimiter, MaxTokensLimiter, MaxAliasesLimiter, error masking |

Async and Subscriptions

| Topic | Reference | Use for | | ------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | Async and Subscriptions | references/async-and-subscriptions.md | AsyncGraphQLView, sync_to_async ORM access, Channels + AuthGraphQLProtocolTypeRouter, broadcasting subscriptions, pitfalls mixing sync and async resolvers |

Testing

| Topic | Reference | Use for | | ------- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | | Testing | references/testing.md | strawberry_django.test.client.TestClient, client.login(), assertNumQueries for optimizer regressions, async tests, snapshot schema diffs |