NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #4236 most downloaded on pub.dev
Flutter SDK for Koolbase — feature flags, remote config, version enforcement, authentication, storage, database, realtime, OTA updates, and code push for mobile apps.
Latest stable
12.53.0
Last release 11 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 months old
149 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
…concurrent in-flight requests, and honestly deprecates OAuth methods that were never fully wired up on the server side.
A comprehensive overhaul of the authentication module. This release closes seven independent gaps identified by a focused security and reliability audit, adds proper device-attributed session tracking, fixes a refresh-token race that could invalidate concurrent in-flight requests, and honestly deprecates OAuth methods that were never fully wired up on the server side.
Backwards compatible: no breaking changes. Existing code paths continue to work.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Koolbase.auth, calls to Koolbase.functions.invoke() include their access token in the request.ctx.auth — a map with user_id (string or null) and is_authenticated (bool).AUTH_REQUIRED if needed.Sign users in with their phone number — for emerging markets and apps where email isn't the primary identifier.
Sign users in with their phone number — for emerging markets and apps where email isn't the primary identifier.
New methods on Koolbase.auth:
sendOtp({required String phoneNumber}) — sends a 6-digit OTP to an E.164 phone number, returns the expiry timestamp.verifyOtp({required String phoneNumber, required String code}) — verifies the code and signs the user in (creates the account if new). Returns PhoneVerifyResult with an isNewUser flag for routing first-time users to onboarding.linkPhone({required String phoneNumber, required String code}) — links a phone number to an already-authenticated user.New types: OtpSendResult, PhoneVerifyResult.
KoolbaseUser now exposes phoneNumber and phoneVerified fields.
New exceptions: InvalidPhoneNumberException, OtpExpiredException, OtpInvalidException, OtpMaxAttemptsException, OtpRateLimitException, PhoneAlreadyLinkedException, SmsConfigMissingException.
Phone numbers must be in E.164 format (e.g. +233244000000). Configure your SMS provider (Twilio, Africa's Talking, or Hubtel) in the Koolbase dashboard before using.
README update — full feature documentation
16 new operators: gte, lte, contains, starts_with, ends_with, in_list, not_in_list, between, is_true, is_false, not_exists and more
gte, lte, contains, starts_with, ends_with, in_list, not_in_list, between, is_true, is_false, not_exists and moreKoolbaseAppleAuth.signIn() — full Apple sign-in flowKoolbase.messaging.registerToken() — register FCM device tokensKoolbase.messaging.send() — send push notifications via FCMdependencies:
koolbase_flutter: ^2.6.3
Full docs at docs.koolbase.com
Removed deprecated encryptedSharedPreferences parameter
README update — Logic Engine v2 operators
contains — string or list contains value
New operators:
gte — greater than or equalslte — less than or equalscontains — string or list contains valuestarts_with — string starts withends_with — string ends within_list — value is in a listnot_in_list — value is not in a listbetween — numeric value in range [min, max]is_true — value is boolean trueis_false — value is boolean falsenot_exists — value is null or missingAll operators work with AND/OR condition groups.
{
"op": "and",
"conditions": [
{ "op": "gte", "left": { "from": "context.usage" }, "right": 5 },
{ "op": "in_list", "left": { "from": "context.plan" }, "right": ["free", "trial"] }
]
}
README update — added Sign in with Apple section
Added KoolbaseAppleAuth.signIn() — Sign in with Apple for Flutter
KoolbaseAppleAuth.signIn() — Sign in with Apple for FlutterKoolbaseAuthClient.oauthLogin() — unified OAuth login methodAuthApi.oauthLogin() — server-side Apple identity token verificationimport 'package:koolbase_flutter/koolbase_flutter.dart';
final session = await KoolbaseAppleAuth.signIn();
if (session != null) {
print('Signed in: \${session['user']['email']}');
}
Add sign_in_with_apple to your pubspec.yaml and configure your App ID in the Apple Developer portal.
Added KoolbaseMessaging — push notification delivery via FCM
KoolbaseMessaging — push notification delivery via FCMKoolbase.messaging.registerToken(token, platform) — register FCM device token with KoolbaseKoolbase.messaging.send(to, title, body, data) — send push notification to a specific deviceKoolbaseConfig extended with messagingEnabled parameter (default: true)// After obtaining FCM token from firebase_messaging
final fcmToken = await FirebaseMessaging.instance.getToken();
await Koolbase.messaging.registerToken(
token: fcmToken!,
platform: 'android', // or 'ios'
);
// Send to a specific device
await Koolbase.messaging.send(
to: deviceToken,
title: 'Your order is ready',
body: 'Pick up at counter 3',
data: {'order_id': '123'},
);
Add your FCM server key as a project secret named FCM_SERVER_KEY in the Koolbase dashboard.
Updated README — added Code Push, Analytics, Logic Engine sections, comparison table, clearer get started guide
Added KoolbaseAnalyticsClient — event tracking with batched flush
KoolbaseAnalyticsClient — event tracking with batched flushKoolbase.analytics — top-level static accessorKoolbase.analytics.track(eventName, properties) — custom event trackingKoolbase.analytics.screenView(screenName) — screen view trackingKoolbase.analytics.setUserProperty(key, value) — user property managementKoolbase.analytics.identify(userId) — attach authenticated user to eventsKoolbase.analytics.reset() — clear user identity on logoutKoolbaseNavigatorObserver — auto screen tracking via Flutter navigatorapp_open, screen_view, session_endKoolbaseConfig extended with analyticsEnabled parameter (default: true)// Auto screen tracking
MaterialApp(
navigatorObservers: [
KoolbaseNavigatorObserver(client: Koolbase.analytics),
],
)
// Manual tracking
Koolbase.analytics.track('purchase', properties: {
'value': 1200,
'currency': 'GHS',
});
// User identity
Koolbase.analytics.identify(user.id);
Koolbase.analytics.setUserProperty('plan', 'pro');
// Flush on app background
Koolbase.analytics.flush();
Added FlowExecutor — safe, deterministic runtime for evaluating flow node trees
FlowExecutor — safe, deterministic runtime for evaluating flow node treesFlowContext — resolves data from context, config, and flags with dot-notation supportFlowResult — typed result with event name, args, and error stateif, sequence, event (terminal), seteq, neq, gt, lt, and, or, existscontext (app-provided), config (bundle), flags (bundle)BundlePayload extended with flows field — Map<String, dynamic> defaulting to {}KoolbaseDynamicScreen now auto-executes flows on rfw events — if a flow emits a new event, that event is passed to onEvent insteadKoolbase.executeFlow() — top-level static accessorKoolbaseCodePushClient.executeFlow() — direct client accessKoolbaseScreenClient abstract interface extended with executeFlow()// In your bundle's flows.json
{
"on_checkout_tap": {
"type": "if",
"condition": {
"op": "eq",
"left": { "from": "context.plan" },
"right": "free"
},
"then": { "type": "event", "name": "show_upgrade" },
"else": { "type": "event", "name": "go_checkout" }
}
}
// In your app — flows execute automatically from KoolbaseDynamicScreen events
// Or call directly:
final result = Koolbase.executeFlow(
flowId: 'on_checkout_tap',
context: { 'plan': user.plan },
);
if (result.hasEvent) {
Navigator.pushNamed(context, result.eventName!);
}
Added KoolbaseDynamicScreen — drop-in widget that renders server-defined UI from the active bundle
KoolbaseDynamicScreen — drop-in widget that renders server-defined UI from the active bundleKoolbaseCodePushScope — InheritedWidget that wires the code push client into the widget treeKoolbaseRfwWidget — registration type for custom widgets in the rfw runtimeScreenResolver — extracts and caches rfw binaries from the active bundle zipscreens field — map of screenId to .rfw filenameKoolbaseDynamicScreen guarantees: never crash, never block, never surprise — all failures fall back to the local widgetKoolbaseCodePushScope.of(context) moved to didChangeDependencies to avoid initState context restrictions// Wrap your app with KoolbaseCodePushScope
KoolbaseCodePushScope(
client: Koolbase.codePush,
child: MyApp(),
)
// Drop KoolbaseDynamicScreen anywhere
KoolbaseDynamicScreen(
screenId: 'onboarding',
data: {'username': user.name},
onEvent: (name, args) {
if (name == 'get_started') Navigator.pushNamed(context, '/home');
},
fallback: const OnboardingScreen(),
)
Added KoolbaseCodePushClient — full bundle lifecycle management (check, download, verify, cache, activate)
KoolbaseCodePushClient — full bundle lifecycle management (check, download, verify, cache, activate)BundleCache — four-slot cache system (pending, ready, active, archive)BundleVerifier — sha256 checksum verification on every downloadKoolbaseUpdater — background check and download on cold launchBundleLoader — promotes ready bundles to active, handles rollbackRuntimeOverrideEngine — merges bundle config and flags with merge precedence: app defaults → Remote Config → Runtime BundleKoolbase.configInt(), configString(), configDouble(), configBool() — now transparently return bundle values when a bundle is activeKoolbase.isEnabled() — now checks bundle flag overrides firstKoolbaseConfig — new codePushChannel parameter (default: 'stable')Koolbase.codePush — new static accessor for the code push clientAdd codePushChannel to your KoolbaseConfig if you want to subscribe to a specific channel:
await Koolbase.initialize(KoolbaseConfig(
publicKey: 'pk_live_xxx',
baseUrl: 'https://api.koolbase.com',
codePushChannel: 'stable', // new — defaults to 'stable'
));
No other breaking changes.
Nothing published for this version
Functions: Added Dart runtime support
FunctionRuntime enum — FunctionRuntime.deno and FunctionRuntime.dartdeploy() method — deploy functions directly from Flutterinvoke() request body formatDatabase: Offline-first support powered by Drift
Koolbase.db.syncPendingWrites()QueryResult.isFromCache flagDatabase: Added .populate() support on query builder for relational data
.populate() support on query builder for relational data
.populate(['author_id:users', 'category_id:categories'])data with the _id suffix removed (e.g. author_id → author)Nothing published for this version
Full BaaS feature set — auth, database, storage, realtime, functions, feature flags, remote config, version enforcement, OTA updates
OTA Updates: Added Koolbase.ota — over-the-air bundle updates for Flutter apps
Koolbase.ota — over-the-air bundle updates for Flutter appsRealtime: Added Koolbase.realtime — WebSocket realtime SDK
Koolbase.realtime — WebSocket realtime SDK
Koolbase.realtime.on(projectId, collection) — stream of all eventsKoolbase.realtime.onRecordCreated(projectId, collection) — stream of new recordsKoolbase.realtime.onRecordUpdated(projectId, collection) — stream of updated recordsKoolbase.realtime.onRecordDeleted(projectId, collection) — stream of deleted record IDsKoolbase.realtime.connectionState — stream of connection status (true/false)Koolbase.realtime.setToken(token) — set auth token for subscriptionsDatabase: Added Koolbase.db — database SDK
Koolbase.db — database SDK
Koolbase.db.collection('name').get() — query records with fluent builderKoolbase.db.collection('name').where('field', isEqualTo: value).limit(20).get()Koolbase.db.insert(collection: 'name', data: {...}) — insert recordsKoolbase.db.doc(id).get() — fetch single recordKoolbase.db.doc(id).update({...}) — patch record fieldsKoolbase.db.doc(id).delete() — soft delete recordKoolbaseRecord, KoolbaseCollection, QueryResult modelsStorage: Added Koolbase.storage — file storage SDK
Koolbase.storage — file storage SDK
upload() — upload files directly to Cloudflare R2 via presigned URLsgetDownloadUrl() — get signed download URLs for private filesdelete() — delete files from storageKoolbaseObject, KoolbaseBucket, UploadResult modelsAuth: Added Koolbase.auth — full authentication SDK
Koolbase.auth — full authentication SDK
signUp, login, logout, forgotPassword, resetPassword, verifyEmailcurrentUser, isAuthenticated, authStateChanges streamflutter_secure_storageKoolbaseUser, AuthSession modelsKoolbaseAuthException and typed exceptionsFeature flags with rollout percentages and kill switches