Skip to content
Storyblok Kotlin Multiplatform SDK (Android, JVM, JS, iOS, ...)
Kotlin
Branch: develop
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
DEV
app
gradle
library
.gitignore
CHANGELOG.md
CONTRIBUTORS.md
LICENSE
MIGRATION.md
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

storyblok-mp-SDK

This is the Storyblok Kotlin Multiplatform client for easy access of the read API. It uses Kotlin multiplatform and coroutines to offer a convenient API for all supported target architectures.

More about Storyblok

Include in your project

Using Gradle

Common

For experimental Kotlin multiplatform projects the common module can only access APIs that are available on all the targets.

dependencies {
    implementation("com.mikepenz:storyblok-mp-sdk:${version}")
}

JVM

To use the storyblok SDK on JVM, you have to include:

dependencies {
    implementation("com.mikepenz:storyblok-mp-sdk-jvm:${version}")
}

Android

For Android a special dependency is provided:

dependencies {
    implementation("com.mikepenz:storyblok-mp-sdk-android:${version}")
}

iOS

For iOS you will have to use the Kotlin Native support and use the following dependency:

dependencies {
    implementation("com.mikepenz:storyblok-mp-sdk-ios:${version}")
}

JS

For JS (node-js) applications you will have to use the Kotlin JS support and the following dependency:

dependencies {
    implementation("com.mikepenz:storyblok-mp-sdk-js:${version}")
}

How to use

Init client

val client = Storyblok("your-storyblok-token")

General

This Kotlin multi platform library uses Kotlin coroutines for the requests (similar to the ktor API). All fetch methods are suspending functions, and need to be called respectively.

Load a story

client.fetchStory("full_slug:id:uuid")
// All storyblock params are supported, see javadoc for more information

Load a list of stories

client.fetchStories()
// All storyblock params are supported, see javadoc for more information

Load current space

client.fetchCurrentSpace()

Load a list of datasources

client.fetchDatasources()
// All storyblock params are supported, see javadoc for more information

Load a map of datasource entries

client.fetchDatasourceEntries()
// All storyblock params are supported, see javadoc for more information

Load a list of map of links with their uuid as key

client.fetchLinks()
// All storyblock params are supported, see javadoc for more information

Load a list of tags

client.fetchTags()
// All storyblock params are supported, see javadoc for more information

Libs used in android sample app:

Mike Penz:

Developed By

Contributors

This free, open source software was also made possible by a group of volunteers that put many hours of hard work into it. See the CONTRIBUTORS.md file for details.

Credits

Some parts of the Kotlin Multiplatform configurations are a result of various great resources on the internet. Including:

License

Copyright 2020 Mike Penz

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.