​
I’m Mr. Meeseeks! Look at me!

Meeseeks is a Kotlin Multiplatform library for effortless background task scheduling. Inspired by Meeseeks-friendly and cheerful beings motivated to help who are summoned to complete a task and disappear after it’s done-it handles everything from simple one-off jobs to complex periodic workflows—so you can focus on building great features instead of wrestling with scheduling code.

​
Why Meeseeks?

Whether you need to periodically sync data, schedule local notifications, or run computational tasks behind the scenes, Meeseeks provides:

Simplicity

Summoning a Meeseeks is easy. No more fiddling with complicated job schedulers or manual timers. Drop in a few lines of code, and let Meeseeks do the rest.

Reliability

Backed by WorkManager on Android, Quartz Job Scheduling on JVM, BGTaskScheduler on native (iOS), and Background Synchronization API on JS (Web). Even if the app closes or the device restarts, your tasks persist.

Intelligent Retry Policies

Because not all tasks are created equal. Choose from exponential backoff, fixed intervals, or custom strategies to ensure your tasks complete successfully.

Multiplatform

Write once, run anywhere. Bring the power of Meeseeks to Android, iOS, web, desktop, and beyond using a single Kotlin codebase.

​
This is a Meeseeks box

A Meeseeks Box lets you summon a Meeseeks to complete a task. Once the Meeseeks completes its task, it disappears. Here’s a primer from Rick:

​
Let me show you how it works

With just a few lines, you can register your task types and summon Meeseeks:

1

Initialize Meeseeks

Meeseeks.initialize(
    context,
    config
) {
    register(MeeseeksType.SYNC) { task -> SyncingMeeseeks(task) }
    register(MeeseeksType.POLL) { task -> PollingMeeseeks(task) }
  }
}
2

Press the button

val meeseeksBox = MeeseeksBox.value
3

Make a request

val task = Task(
  MeeseeksType.SYNC,
  parameters = taskParametersOf {
    KEY_USER_ID to "RICKC137"
    KEY_DIMENSION_ID to 137
    KEY_SYNC_PROTOCOL to SyncProtocol.INTERDIMENSIONAL
    KEY_COUNCIL_OVERRIDE to true
    KEY_USER_TAGS toList {"portal-gun-user"}
  },
  preconditions = TaskPreconditions(
    requiresNetwork = true,
    requiresCharging = false,
    requiresBatteryNotLow = false
  ),
  priority = TaskPriority.HIGH,
  schedule = TaskSchedule.Periodic(interval = 60.seconds),
  retryPolicy = TaskRetryPolicy.ExponentialBackoff(initialDelay = 1.seconds, maxRetries = 3)
)

val meeseeksId = meeseeksBox.summon(task)
4

Meeseeks fulfills the request

5

And then it stops existing

​
Next steps

Intro to Meeseeks

Dive into Meeseeks’ core architecture and how it handles tasks behind the scenes.

Quickstart

Learn how to get up and running with Meeseeks in just a few minutes.

Cookbook

Browse real-world examples and recipes for common scheduling scenarios.

​
Built with ❤️ by

store-light

Store

The solution for working with data in Kotlin. Whether you’re building alone or with a team of thousands, Store can help.

store-dark

Store

The solution for working with data in Kotlin. Whether you’re building alone or with a team of thousands, Store can help.

mobile-native-foundation

Mobile Native Foundation

Improving engineering for large-scale mobile applications.

kotlin-foundation

Kotlin Foundation

Protect, promote and advance the development of the Kotlin programming language.

Was this page helpful?

Suggest editsRaise issue