Skip to content

Commit ba9ec1a

Browse files
committed
chore(docs): add docsify documentation
1 parent ee36cbc commit ba9ec1a

File tree

4 files changed

+74
-0
lines changed

4 files changed

+74
-0
lines changed

docs/.nojekyll

Whitespace-only changes.

docs/README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# GraphQL Kotlin Toolkit
2+
[![GitHub Actions](https://github.com/AurityLab/graphql-kotlin-toolkit/workflows/Gradle/badge.svg)](https://github.com/AurityLab/graphql-kotlin-toolkit/actions)
3+
[![ktlint](https://img.shields.io/badge/code%20style-%E2%9D%A4-FF4081.svg)](https://ktlint.github.io/)
4+
[![Maven Central](https://img.shields.io/maven-central/v/com.auritylab.graphql-kotlin-toolkit/codegen?label=codegen)](https://mvnrepository.com/artifact/com.auritylab.graphql-kotlin-toolkit/codegen)
5+
[![Maven Central](https://img.shields.io/maven-central/v/com.auritylab.graphql-kotlin-toolkit/spring-boot?label=spring%20boot%20integration)](https://mvnrepository.com/artifact/com.auritylab.graphql-kotlin-toolkit/spring-boot)
6+
7+
A toolkit for GraphQL, specifically for [Kotlin](https://kotlinlang.org/). This toolkit provides some useful tools that are compatible with [graphql-java](https://github.com/graphql-java/graphql-java).
8+
9+
## Code generation
10+
This tool follows the **schema-first** approach, in which you first write your *schema.graphqls* files and implement the server-side code for it afterwards.
11+
This code generator additionally creates an interface for each resolver.
12+
These can be used to implement each resolver in a clean way. The tool also provides specific parameters for each argument, allowing a more type safe way to access the incoming data.
13+
This code generator also **supports Kotlin's null safety feature**!
14+
15+
Example resolver:
16+
```kotlin
17+
class MutationUpdateUser : GQLMutationUpdateUser {
18+
override fun resolve(input: GQLUpdateUserInput, env: GQLMutationUpdateUser.Env): User {
19+
TODO("implement your resolver")
20+
}
21+
}
22+
```
23+
24+
**Getting started [here](docs/codegen/gettings-started.md)!**
25+
26+
27+
## Spring Boot integration
28+
This integration works in a more opinionated way as it provides additional annotations which can be used to register code for various GraphQL types.
29+
It also comes with a servlet, which handles all GraphQL requests.
30+
31+
**Getting started [here](docs/spring-boot-integration/getting-started.md)!**
32+
33+
34+
## Documentation
35+
* Code generation
36+
* [Getting started (Gradle Plugin)](docs/codegen/gettings-started.md)
37+
* [Schema configuration](docs/codegen/schema-configuration.md)
38+
* [Advanced configuration (Gradle Plugin)](docs/codegen/advanced-configuration.md)
39+
* [Code generation with Spring Boot integration](docs/codegen/code-generation-with-spring-boot-integration.md)
40+
* Spring Boot integration
41+
* [Getting started](docs/spring-boot-integration/getting-started.md)
42+
* [Annotations](docs/spring-boot-integration/annotations.md)

docs/_sidebar.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
* Code generation
2+
* [Getting started (Gradle Plugin)](/codegen/gettings-started.md)
3+
* [Schema configuration](/codegen/schema-configuration.md)
4+
* [Advanced configuration (Gradle Plugin)](/codegen/advanced-configuration.md)
5+
* [Code generation with Spring Boot integration](/codegen/code-generation-with-spring-boot-integration.md)
6+
* Spring Boot integration
7+
* [Getting started](/spring-boot-integration/getting-started.md)
8+
* [Annotations](/spring-boot-integration/annotations.md)
9+

docs/index.html

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8">
5+
<title>GraphQL Kotlin Toolkit</title>
6+
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
7+
<meta name="description" content="Description">
8+
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
9+
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css">
10+
</head>
11+
<body>
12+
<div id="app"></div>
13+
<script>
14+
window.$docsify = {
15+
name: 'GraphQL Kotlin Toolkit',
16+
repo: 'https://github.com/AurityLab/graphql-kotlin-toolkit',
17+
loadSidebar: true
18+
}
19+
</script>
20+
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
21+
<script src="//cdn.jsdelivr.net/npm/prismjs@1/components/prism-kotlin.min.js"></script>
22+
</body>
23+
</html>

0 commit comments

Comments
 (0)