Repository files navigation

GraphQL Kotlin is a collection of libraries, built on top ofgraphql-java, that simplify running GraphQL clients and servers in Kotlin.

Visit ourdocumentation site for more details.

• clients - Lightweight GraphQL Kotlin HTTP clients based on Ktor HTTP client and Spring WebClient
• examples - Example apps that use graphql-kotlin libraries to test and demonstrate usages
• generator - Code-First schema generator and extensions to build Apollo Federation schemas
• plugins - Gradle and Maven plugins
• servers - Common and library specific modules for running a GraphQL server

While all the individual modules ofgraphql-kotlin are published as stand-alone libraries, the most common use cases are running a server, and genereating a type-safe client.

A basic example of how you can run a GraphQL server can be found on ourserver documentation section.

A basic setup of a GraphQL client can be found on ourclient documentation section.

More examples and documentation are available on ourdocumentation site hosted in GitHub Pages.We also have theexamples module which can be run locally for testing and shows example code using the libraries.

If you have a question about something you can not find in our documentation, the indivdual module READMEs, orjavadocs, feel free to contribute to the docs orstart a disucssion and tag it with the question label.

If you would like to contribute to our documentation see thewebsite directory for more information.

TheBlogs & Videos page in the GraphQL Kotlin documentation links to blog posts, release announcements, conference talks about the library, and general talks about GraphQL at Expedia Group.

This project is part of Expedia Group Open Source but also maintained by a dedicated team

• Expedia Group OSS

  • https://expediagroup.github.io

• GraphQL Kotlin Committers

  • Github team:@ExpediaGroup/graphql-kotlin-committers

If you have a specific question about the library or code, pleasestart a disucssion for the community.

We also have a public channel, (#graphql-kotlin), open on the Kotlin Slack instance (kotlinlang.slack.com).See the infohere on how to join this slack instance.

To get started, please fork the repo and checkout a new branch. You can then build the library locally with Gradle

./gradlew clean build

See more info inCONTRIBUTING.md.

After you have your local branch set up, take a look at ouropen issues to see where you can contribute.

For more info on how to contact the team for security issues or the supported versions that receive security updates, seeSECURITY.md

This library is licensed under theApache License, Version 2.0