Storyblok Kotlin

Welcome to Storyblok's repository for all things Kotlin, including Android and Kotlin Multiplatform.

What is Storyblok?

Storyblok is a headless content management system (CMS) that empowers developers and content creators. It provides a visual editor for content teams while giving developers the flexibility to build with their preferred tech stack and deliver content through APIs to any platform or device.

Changelog

0.6.0

• BREAKING CHANGE: StoryblokClient.stories(...) returns an androidx.paging.Pager<Int, Story<T>> rather than a Flow<PagingData<Story<T>>>.

• The Content Delivery API Client now declares kotlinx-datetime as an api dependency. Story.sortByDate and StoryblokDateTimeSerializer expose its types, so consumers needed it on their compile classpath already.

• Updated kotlinx-datetime to 0.8.0 and Ktor to 3.5.2.

• Added a samples/JetNewsCMP, a port of the JetNews sample running the same shared UI on Android, iOS, desktop and the web.

0.5.0

• Added StoryblokClient.stories(...) for the retrieve multiple stories endpoint, returning a Flow<androidx.paging.PagingData<Story<T>>>.

• BREAKING CHANGE: the Content Delivery API Client no longer publishes the iosX64 and androidNativeArm32/androidNativeArm64/androidNativeX64/androidNativeX86 targets, which androidx.paging:paging-common does not support.

0.4.0

• The Content Delivery API Client now persists its HTTP cache to disk on JVM and Android, so cached responses survive a process restart. Other targets are unchanged and keep the in-memory cache.

• Fixed the resolve_relations query parameter being built in a non-deterministic order ensuring cache key is stable across processes.

• Fixed SerializationException getting wrongly wrapped in StoryblokClientException.

0.3.0

• BREAKING CHANGE: the Storyblok(...) composable's parameter is renamed blokProvider → blockProvider so named-argument callers must update the label. Positional callers are unaffected.

• Fixed resolving relations for blocks embedded in rich text (com.storyblok.cdn.StoryblokClientException: Expected JsonObject, but had JsonLiteral)

• Added a resolveLevel parameter to the story() functions to control how deeply story relations are resolved.

• Fixed a StackOverflowError when resolving circular story relations

0.2.0

• Added JetNews sample app

• Initial release of the Compose SDK

• Initial release of the Material 3 Rich Text Provider

• Initial release of the Content Delivery Client

• Add only-if-cached support to the Storyblok Ktor Client Plugin

0.1.0

• Initial release of the Storyblok Ktor Client Plugin