Documentation | Discord

Strawberry GraphQL Django integration provides powerful tools to build GraphQL APIs with Django. Automatically generate GraphQL types, queries, mutations, and resolvers from your Django models with full type safety.

pip install strawberry-graphql-django

• 🍓 Automatic Type Generation - Generate GraphQL types from Django models with full type safety
• 🔍 Advanced Filtering - Powerful filtering system with lookups (contains, exact, in, etc.)
• 📄 Pagination - Built-in offset and cursor-based (Relay) pagination
• 📊 Ordering - Sort results by any field with automatic ordering support
• 🔐 Authentication & Permissions - Django auth integration with flexible permission system
• ✨ CRUD Mutations - Auto-generated create, update, and delete mutations with validation
• ⚡ Query Optimizer - Automatic select_related and prefetch_related to prevent N+1 queries
• 🐍 Django Integration - Works with Django views (sync and async), forms, and validation
• 🐛 Debug Toolbar - GraphiQL integration with Django Debug Toolbar for query inspection

# models.py from django.db import models class Fruit(models.Model): name = models.CharField(max_length=20) color = models.ForeignKey("Color", on_delete=models.CASCADE, related_name="fruits") class Color(models.Model): name = models.CharField(max_length=20)

# types.py import strawberry_django from strawberry import auto from . import models @strawberry_django.type(models.Fruit) class Fruit: id: auto name: auto color: "Color" @strawberry_django.type(models.Color) class Color: id: auto name: auto fruits: list[Fruit]

# schema.py import strawberry import strawberry_django from strawberry_django.optimizer import DjangoOptimizerExtension from .types import Fruit @strawberry.type class Query: fruits: list[Fruit] = strawberry_django.field() schema = strawberry.Schema( query=Query, extensions=[DjangoOptimizerExtension], )

# urls.py from django.urls import path from strawberry.django.views import AsyncGraphQLView from .schema import schema urlpatterns = [ path("graphql/", AsyncGraphQLView.as_view(schema=schema)), ]

That's it! You now have a fully functional GraphQL API with:

• Automatic type inference from Django models
• Optimized database queries (no N+1 problems)
• Interactive GraphiQL interface at /graphql/

Visit http://localhost:8000/graphql/ and try this query:

query { fruits { id name color { name } } }

Check out our comprehensive documentation:

• 📚 Getting Started Guide - Complete tutorial with examples
• 🎓 Example App - Full-featured e-commerce application
• 📖 Documentation - In-depth guides and API reference
• 💬 Discord Community - Get help and share your projects

We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated 😊

Quick Start:

git clone https://github.com/strawberry-graphql/strawberry-django cd strawberry-django pre-commit install

Then run tests with make test or make test-dist for parallel execution.

• 💬 Discord - Join our community for help and discussions
• 🐛 GitHub Issues - Report bugs or request features
• 💡 GitHub Discussions - Ask questions and share ideas

This project is licensed under the MIT License.