GraphDSL

Type-safe GraphQL Kotlin DSL code generator

GraphDSL reads your GraphQL schema and generates a type-safe Kotlin DSL so you can build queries and mutations programmatically — no string templates, no typos, no guessing field names.

---

What it generates

Given a GraphQL schema like this:

type Query {
    post(id: ID!): Post
    authors: [Author!]!
}

type Post {
    id: ID!
    title: String!
    author: Author!
}

type Author {
    id: ID!
    name: String!
    email: String!
}

GraphDSL generates a Kotlin DSL that lets you write:

val query = query(name = "GetPost") {
    post(id = "42") {
        id
        title
        author {
            name
            email
        }
    }
}

No strings. No reflection at runtime. Full IDE autocomplete.

---

How to use it

build.gradle.kts

plugins {
    id("io.github.graphdsl.graphdsl-plugin") version "0.1.4"
}

graphDsl {
    packageName.set("com.example.api.dsl")
    schemaDir.set("src/main/graphql")
}

Run ./gradlew generateDsl — generated sources land in build/generated/graphdsl/.

---

Modules

Module	Purpose
schema	GraphQL schema parsing
mapper	Maps GraphQL types to Kotlin types
codegen	DSL source file generation
gradle-plugins	Gradle build integration
utils	Shared utilities

---

Get started View on GitHub