Ktor codebase written in a functional style containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.
This codebase was created to familiarize myself with Ktor, as well as the graphql-kotlin library. It includes CRUD operations, authentication, routing, pagination, and more.
For more information on how to this works with other frontends/backends, head over to the RealWorld repo.
Also, for the GraphQL implementation switch to the graphql branch.
- Kotlin 1.6 - our language of choice
- Gradle (with Kotlin DSL) - our build tool of choice
- Ktor - for creating web application with Kotlin
- graphql-kotlin - for running GraphQL with Kotlin
- Λrrow - Functional compagnion to Kotlin
- Koin - our dependency injection library
- kotlinx.serialization - for JSON serialization/deserialiation
- Exposed - Kotlin SQL framework for database access
- HikariCP - high-performance JDBC connection pool
- H2 - a lightweight in-memory database used for testing
- kotest - as testing framework for kotlin.
The application uses a package-by-feature structure with the following packages:
common: contains technical configuration classes (e.g. for DI, database connection, connection pooling, logging, etc)users: contains user related routes, domain models, entities and business logicarticles: contains article related routes, domain models, types and business logicprofiles: contains user profiles routes, domain models and business logic
If you have a local MySQL database running on your computer - you are all set. If you don't have MySQL installed, you can do it now by installing from: https://dev.mysql.com/doc/mysql-installation-excerpt/5.7/en/ and set it up with user name and password
Make sure to create a database named realworld in your MySQL instance.
Clone and open ktor-realworld-sample with IntelliJ IDE. Choose Run / Edit Configuration menu to create new launch configuration. On the left side click [+] and select Kotlin. Name it RealWorld Server (or pick other name) and fill up some essential fields:
- Main class:
io.skinnydoo.RealWorldAppKt - Environment variables:
JWT_SECRET=your-secret-here=;DB_USERNAME=root;DB_PWD=your-db-user-password - Use classpath or module:
ktor-realworld-sample.main
You should be able to run/debug your app now.
Credits have to go out to Thinkster with their awesome RealWorld
This project is licensed under the MIT license.
This source and the whole package comes without warranty. It may or may not harm your computer. Please use with care. Any damage cannot be related back to the author.