A Wagtail app that makes building GraphQL endpoints a breeze by adding simple annotations to your models.
Wagtail Grapple is a Python library that enables developers to easily build GraphQL endpoints for Wagtail CMS projects. It solves the problem of complex GraphQL setup by allowing model-level configuration with simple annotations, making Wagtail data accessible from anywhere via GraphQL.
Wagtail developers and teams building headless or decoupled frontends who need to expose their Wagtail content through a GraphQL API.
Developers choose Wagtail Grapple because it dramatically reduces the complexity of creating GraphQL endpoints for Wagtail, requiring no complex serializers and providing out-of-the-box support for all major Wagtail models with minimal configuration.
A Wagtail app that makes building GraphQL endpoints a breeze!
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
By adding a graphql_fields list to models, developers can expose data without writing complex serializers, as demonstrated in the BlogPage example with GraphQLString and GraphQLStreamfield.
Supports all core Wagtail models including Pages with StreamField, Snippets, Images, Media, and Settings, enabling full content API coverage out of the box.
Includes built-in pagination and middleware support, allowing for scalable and flexible API configurations without additional coding, as highlighted in the advanced features.
Works with custom Image and Document models, ensuring compatibility with existing Wagtail customizations, as noted in the features list.
The library does not mention GraphQL subscriptions in its features, limiting real-time capabilities for applications that require live updates.
Exclusively designed for Wagtail, making it unsuitable for general Django projects or non-Wagtail content systems, as it requires Wagtail >=6.3.
Relies on Graphene and Graphene Django, so any bugs, limitations, or breaking changes in these dependencies directly impact Grapple's stability and features.