Shared libraries published to Maven Central; modules versioned and released independently via tag-driven publish workflow that publishes only the tagged module; consumers need only mavenCentral.
Shared Kotlin Multiplatform libraries for Coderwise apps, published to Maven Central
under the com.coderwise.libs group. Consumers need only mavenCentral() — no
credentials.
All modules target Android · iOS (arm64, sim-arm64) · JS · Desktop (the map
modules additionally target Wasm/JS) and publish
under com.coderwise.libs. "Latest" is the newest version on Maven Central.
The sample/ directory holds an unpublished demo app for the map
libraries that runs on all five platforms (Android, iOS, Desktop, JS, Wasm/JS) —
see its README for run commands.
A library manifest merges into every consumer, so a permission declared here is a
permission declared for every app that depends on the module — including apps that
never ask the user for it, but must still justify it on their store listing. An app
using only rememberCameraPermissionState would ship ACCESS_FINE_LOCATION; an app
that registers locationModule in DI without resolving a LocationProvider would ship
both location permissions.
So :permissions and :location declare none. The consuming app declares what it
actually uses — the KDoc on each remember*PermissionState and on LocationProvider
names the Android permission and any Info.plist key it needs.
Migration: :permissions before 0.4.0 and :location before 0.2.0 declared
ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION. Apps that relied on that merge must
add them to their own manifest when upgrading — without the declaration Android denies
the request without prompting, and returns
.
:billing needs a Swift half on iOSStoreKit 2 is Swift-only — Product and Transaction are Swift types built on Swift
concurrency, which Kotlin/Native's Objective-C interop cannot see — so the module ships
no iOS store logic. It exposes a StoreKitBridge protocol that the consuming iOS app
implements in Swift and hands over with installStoreKitBridge(bridge) before anything
resolves Billing.
An app that never calls it still runs: Billing.isAvailable reports false and every call
is inert, which is what keeps the simulator — where there is nothing to buy — working
without one. Android needs no such step; androidContext() is the only thing Play
Billing takes from the app.
Each module is versioned and released independently, via the vanniktech maven-publish plugin (Central Portal upload, GPG signing, sources/javadoc jars).
The release tag is the single source of truth for the version. Tag a module
release as <module>-v<version>; the publish
workflow parses it, passes -PlibVersion, and publishes only that module:
git tag utils-v0.4.0 && git push origin utils-v0.4.0 # → com.coderwise.libs:utils:0.4.0
git tag map-core-v0.1.6 && git push origin map-core-v0.1.6 # → com.coderwise.libs:map-core:0.1.6
Note: the publish workflow runs on a macOS runner (required for the iOS Kotlin/Native targets), which bills GitHub Actions minutes at 10×. Validate locally with
publishToMavenLocalfirst; publish deliberately.
The same workflow also accepts a manual workflow_dispatch (module + version inputs).
It needs these repo secrets (same values as the other coderwise repos —
com.coderwise namespace is already verified): MAVEN_CENTRAL_USERNAME,
MAVEN_CENTRAL_PASSWORD, SIGNING_KEY_ID, SIGNING_PASSWORD, GPG_KEY_CONTENTS.
Local, keyless (publishes as 0.0.0-LOCAL unless -PlibVersion is given):
./gradlew :utils:publishToMavenLocal
Drop it in as a top-level folder with a build.gradle.kts (settings.gradle.kts
auto-includes it). Mirror :utils: apply the vanniktech plugin, read the version
from libVersion (default 0.0.0-LOCAL), set coordinates("com.coderwise.libs", "<name>", …).
Release it with a <name>-v<version> tag — no workflow changes needed.
originated in (published through ) and was extracted here; coordinates are unchanged, so consumers required no edits beyond the version bump. The , , , , , and modules were added here to share infrastructure across the apps. was extracted from (where it lived as ); its package moved from to . was extracted from () the same way, moving from to ; its iOS log file name became a parameter of , having been a hardcoded . came out of () by the same route, moving from to ; nothing about it was app-specific beyond the doc comments, which named the one product MilesOn sells. (utils ) came from the same repo's , which had grown as a better-behaved copy of ; the module was deleted there in favour of this one. Both APIs now share the platform code, so inherited the iPad popover anchor that its own iOS implementation was missing.
| Module | Coordinates | Latest | Summary |
|---|
:utils | com.coderwise.libs:utils | 0.5.0 | Cross-platform utilities: file and text sharing, platform system-bar colors, generic LruCache. |
:permissions | com.coderwise.libs:permissions | 0.6.0 | Runtime permission state (location, camera, Bluetooth, notifications) for Compose Multiplatform, plus rememberAppSettingsLauncher for refusals the OS no longer prompts for. |
:database | com.coderwise.libs:database | 0.1.0 | SQLDelight driver factory + Koin DI. |
:location | com.coderwise.libs:location | 0.3.0 | GPS location provider (current location + updates Flow), with opt-in background delivery on iOS. |
:settings | com.coderwise.libs:settings | 0.1.0 | Typed, serializable settings persistence (DataStore-backed). |
:imagepicker | com.coderwise.libs:imagepicker | 0.1.0 | System image picker (rememberImagePicker) with automatic downscaling. |
:logger | com.coderwise.libs:logger | 0.1.0 | Kermit-backed AppLogger facade, plus enableDeviceVisibleLogging for iOS debug runs that must be diagnosed off-device. |
:billing | com.coderwise.libs:billing | 0.1.0 | One-time (non-consumable) purchases behind one API: Play Billing on Android, a Swift StoreKit 2 bridge on iOS, inert where there is no store. |
:map-core | com.coderwise.libs:map-core | 0.1.6 | Dependency-free map primitives: slippy-map tile math + TileId. |
:map-engine | com.coderwise.libs:map-engine | 0.1.6 | Compose tiled-map engine (pannable/zoomable TiledMap), built on :map-core. |
LocationProviderResult.failure(SecurityException):utilscoderwise/maps-mobile0.2.0com.coderwise.libs:utils:database:settings:location:permissions:map-core:map-engine*.mobile:imagepickercoderwise/cards-mobile:libs:imagepickercom.coderwise.cards.libs.imagepickercom.coderwise.libs.imagepicker:loggercoderwise/miles.mobile:libs:loggercom.coderwise.mileson.libs.loggercom.coderwise.libs.loggerenableDeviceVisibleLoggingmileson.log:billingcoderwise/miles.mobile:libs:billingcom.coderwise.mileson.libs.billingcom.coderwise.libs.billingrememberShareTextLauncher0.5.0:libs:shareshareTextshareTextSurfaced from shared tags and platforms — no rankings paid for.