Skip to content

Commit

Permalink
Create basic README (#15)
Browse files Browse the repository at this point in the history
  • Loading branch information
StefMa authored Oct 2, 2023
1 parent 087788e commit 306dad7
Showing 1 changed file with 45 additions and 0 deletions.
45 changes: 45 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Lokalise API v2 unofficial KMP client library

[![Tests](https://github.com/ioki-mobility/kmp-lokalise-api/actions/workflows/tests.yml/badge.svg)](https://github.com/ioki-mobility/kmp-lokalise-api/actions/workflows/tests.yml)

Inofficial Kotlin Multiplatform implementation of the [Lokalise API](https://developers.lokalise.com/reference/lokalise-rest-api)
targeting `JVM`, `macOS/X64`, `macOS/Arm64`, `Mingw(Windows)/X64` and `Linux/X64`.

## What?

As we needed an JVM implementation of the Lokalise API in one of our projects
but didn't find one, we decided to build our own based on KMP.

Even though we focus on JVM
the other targets has the same priority as the JVM implementation.

## How?

All you need to do is to create an Lokalise API token to create a `Lokalise` instance:

```kotlin
val lokaliseClient = Lokalise("[API_TOKEN]")
```

Optional, you can set `fullLoggingEnabled` to `true` to enable logging for
the HTTP communication.

## Download

### Add the repository

The project is hosted on [GitHub Packages](https://github.com/orgs/ioki-mobility/packages?repo_name=kmp-lokalise-api).

```kotlin
repositories {
maven(url = "https://ghpkgs.cloud/ioki-mobility/kmp-lokalise-api")
}
```

### Add the dependency

```kotlin
dependencies {
implementation("com.ioki:lokalise-api:<latest-version>")
}
```

0 comments on commit 306dad7

Please sign in to comment.