Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jillesvangurp/kmp-template
Template project for creating kotlin multi platform libraries
https://github.com/jillesvangurp/kmp-template
gradle kotlin-multiplatform refreshversions template-project
Last synced: about 2 months ago
JSON representation
Template project for creating kotlin multi platform libraries
- Host: GitHub
- URL: https://github.com/jillesvangurp/kmp-template
- Owner: jillesvangurp
- License: mit
- Created: 2024-02-23T13:18:17.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-04-05T04:21:50.000Z (9 months ago)
- Last Synced: 2024-04-13T03:25:28.028Z (9 months ago)
- Topics: gradle, kotlin-multiplatform, refreshversions, template-project
- Language: Kotlin
- Homepage:
- Size: 58.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# JsonDsl
This is an opinionated template for creating kotlin multi platform library projects.
This works for me and might help you bootstrap your kotlin projects.
## Batteries included
My goal with this is to waste less time setting up new projects. Kotlin multiplatform can be a bit fiddly to get going with and there are a lot of things that I want to add to projects. This gets me there with minimal fiddling.
- Gradle wrapper with recent version of gradle & kts dialect
- [ktfmt](https://github.com/facebook/ktfmt) - Code style is enforced with ktfmt. A matching .editorconfig is included. The style is Kotlin's [official style](kotlinlang.org/docs/coding-conventions.html). Tip, configure your IDE to format on save.
- [Refresh versions plugin](https://splitties.github.io/refreshVersions/) - Great way to manage dependencies and stay on top of updates.
- [kotlin4example](https://github.com/jillesvangurp/kotlin4example) integrated to generate the readme and any other documentation you are going to write. This is all driven via the tests.
- Some dependencies for testing (junit, kotest-assertions, etc.) and test setup for junit
- generic publish script that tags and publishes
- Github action that builds your stuff generated using [github-workflows-kt](https://github.com/typesafegithub/github-workflows-kt). Setup to cache gradle and konan related files to speed up your builds.
- LICENSE file (MIT)
## Usage & project create checklist
- [ ] Go to Github and push the "Use this template" button. This will create a new project based on this template
- [ ] Fix your project name by changing `rootProject.name = "my-new-kmp-project"` in settings.gradle.kts. Override the group name in gradle.properties
- [ ] Review default maven repo for releases and other things in build.gradle.kts
- [ ] Update copyright file
- [ ] Start writingb your own README.md by modifying the code that generates it
## Gradle
This library is published to our own maven repository.
```kotlin
repositories {
mavenCentral()
maven("https://maven.tryformation.com/releases") {
// optional but it speeds up the gradle dependency resolution
content {
includeGroup("com.jillesvangurp")
includeGroup("com.tryformation")
}
}
}
```
And then you can add the dependency:
```kotlin
// check the latest release tag for the latest version
implementation("com.jillesvangurp:my-new-kmp-project:1.x.y")
```
## Example
The main feature of [kotlin4example](https://github.com/jillesvangurp/kotlin4example) is of course integrating code samples into your documentation.
### Hello World
```kotlin
println("Hello World!")
```
And you can actually grab the output and show it in another code block:
```text
Hello World!
```
## Multi platform
This is a Kotlin multi platform library that should work on most kotlin platforms (jvm, js, ios, android, etc). Wasm will be added later, after Kotlin 2.0 stabilizes.