sangria-akka-http-example
A GraphQL server example built with akka-http, circe, and sangria, demonstrating Star Wars API implementation.
What is sangria-akka-http-example?
Sangria akka-http Example is a GraphQL server implementation built with Scala technologies, specifically using sangria for GraphQL, akka-http for HTTP handling, and circe for JSON processing. It provides a working example of a GraphQL API with a Star Wars-themed schema, demonstrating how to handle queries, variables, and HTTP best practices. The project serves as a reference for developers looking to build GraphQL servers in Scala.
Scala developers and backend engineers who want to implement GraphQL APIs using the sangria library with akka-http and circe. It's ideal for those seeking a practical example to learn from or bootstrap their own GraphQL projects.
Developers choose this example because it offers a complete, runnable GraphQL server with industry-standard Scala libraries, clear documentation, and interactive query capabilities via GraphQL Playground. It demonstrates real-world patterns like variable handling and HTTP compliance in a concise, easy-to-understand format.
Overview
An example GraphQL server written with akka-http, circe and sangria
Use Cases
Best For
- Learning GraphQL server implementation in Scala
- Building GraphQL APIs with sangria and akka-http
- Creating example projects for educational purposes
- Testing GraphQL queries with interactive playgrounds
- Referencing HTTP best practices for GraphQL endpoints
- Developing backend services with Star Wars-themed mock data
Not Ideal For
- Production applications requiring custom data persistence and business logic integration
- Teams using alternative HTTP servers in Scala, such as http4s or Play Framework
- Projects needing advanced GraphQL features like real-time subscriptions or schema federation
Pros & Cons
Pros
Demonstrates seamless integration of sangria for GraphQL, akka-http for HTTP, and circe for JSON, providing a reference for standard Scala stacks as shown in the README setup.
Includes GraphQL Playground for interactive query testing at the root endpoint, facilitating easy experimentation and debugging directly in the browser.
Follows GraphQL HTTP guidelines, showing proper handling of POST requests with JSON bodies and variables, as evidenced in the curl examples provided.
Cons
The Star Wars-themed schema is static and only includes basic queries with mock data, lacking mutations, complex types, or real-world data integration.
Focuses solely on example code without advice on deployment, scaling, or error handling, making it insufficient for production use without significant modifications.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.