Getting Startedv2.4.0

Welcome to Koolbase

Koolbase is Backend as a Service built for mobile developers. Auth, database, storage, realtime, functions, feature flags, code push, analytics, and cloud messaging — one SDK for Flutter and React Native.

What is Koolbase?

Koolbase gives your Flutter app a complete backend without the complexity of managing infrastructure. Register users, store data, upload files, stream live updates, deploy serverless functions, and control feature rollouts — all from a single SDK and one dashboard.

Most backend platforms are built for the web and adapted for mobile as an afterthought. Koolbase is different — built from the ground up for Flutter and React Native, with mobile-specific primitives like code push, version enforcement, offline-first caching, and OTA updates baked in from day one.

The SDK initialises once with your API key. From there, every module — Koolbase.auth, Koolbase.db, Koolbase.storage, and more — is available throughout your app.

What's Included

Authentication

Register, login, email verification, password reset, and OAuth. JWT sessions scoped per environment.

Database

Flexible JSONB collections with access rules (public, authenticated, owner). Realtime subscriptions included.

Storage

Upload files directly from the device to Cloudflare R2 using presigned URLs. Organized in buckets.

Realtime

WebSocket subscriptions for live data. Records stream instantly when created, updated, or deleted.

Functions

Deploy TypeScript functions on Deno. Invoke via HTTP or bind to DB events. Retry + DLQ built in.

Feature Flags

Toggle features without redeploying. Percentage-based rollouts and targeted releases.

Remote Config

Update strings, numbers, booleans, and JSON from the dashboard. No app release required.

Version Enforcement

Force or soft-prompt users to update. Set a minimum version per environment with a custom message.

Code Push & OTA

Push config, flags, and UI updates to production without a store release. Versioned, signed, rolled back in one click.

Analytics

Track screen views, custom events, DAU/WAU/MAU, funnels, and retention cohorts — no third-party SDK needed.

Cloud Messaging

Send push notifications via FCM. Register device tokens, broadcast to all users, and track delivery from the dashboard.

How it works

01

Create a project and environments

Sign up, create a project, and set up your environments (production, staging, development). Each environment gets its own public API key.

02

Add the Flutter SDK

Add koolbase_flutter: ^2.4.0 to your pubspec.yaml and call Koolbase.initialize(KoolbaseConfig(...)) once in your app. The entire platform is now available.

03

Build with the full platform

Use Koolbase.auth for user management, Koolbase.db for data, Koolbase.storage for files, and Koolbase.realtime for live updates.

04

Control from the dashboard

Toggle feature flags, update remote config, enforce minimum versions, deploy functions, and manage users — all from app.koolbase.com.

SDK Version History

v2.4.0Cloud Messaging — FCM token registration, send, broadcastlatest
v2.3.0Analytics — DAU/WAU/MAU, events, funnels, retention
v2.2.0Logic Engine v1 — OTA event-driven flows
v2.1.0Server-Driven UI — rfw, KoolbaseDynamicScreen
v2.0.0Code Push — bundle cache, verifier, runtime override
v1.9.0Functions — Dart runtime, deploy from SDK
v1.8.0Offline-first — Drift, cache-first, optimistic writes
v1.0.0Auth, Database, Storage, Realtime, Feature Flags, Remote Config

Next Steps