Quick Start

Integrate Growise in minutes: get an API key, install the right SDK (web, Android, or Flutter), initialize once, identify users, and send your first event.

Introduction

By the end of this guide you will have a working SDK install, authenticated project key usage, identified users, and at least one custom event in the Growise debugger.

Prerequisites

  • A Growise account and project
  • Project API key (gk_…)
  • Web: Node/npm or CDN access · Android: Studio + Firebase · Flutter: Flutter SDK + Android host

Choose your SDK

  • Web (HTML / Vue / Angular / React) → @growise/web-sdk — see JavaScript & React SDK pages
  • Android (Kotlin/Java) → com.growwise:growwise-sdk:1.2.0
  • Flutter → growwise_flutter (Android host)

Web — install & init

npmbash
npm install @growise/web-sdk
Initializejavascript
import growise from '@growise/web-sdk'

await growise.init('YOUR_PROJECT_API_KEY', {
  env: 'prod',
  appVersion: '1.0.0',
})

growise.track('Page Ready')
CDNhtml
<script src="https://cdn.thegrowise.com/js/v1/growise.umd.js"></script>
<script>
  window.growise.init('YOUR_PROJECT_API_KEY', { env: 'prod' });
</script>

Android — install & init

Application.onCreatekotlin
val config = GrowWiseConfig.Builder(this)
    .setApiKey("YOUR_API_KEY")
    .setSmallIcon(R.drawable.ic_notification)
    .build()

GrowWise.initialize(this, config)
GrowWise.logEvent("app_opened")

Flutter — install & init

pubspec.yamlyaml
dependencies:
  growwise_flutter:
    path: ../growwise-flutter-sdk
main.dartdart
WidgetsFlutterBinding.ensureInitialized();

await GrowWise.initialize(
  apiKey: 'YOUR_API_KEY',
  smallIconName: 'ic_notification',
);

runApp(const MyApp());

Identify + track

Webjavascript
growise.onUserLogin({
  Site: { Identity: 'user_123', Email: 'a@b.com', Name: 'Alex' },
})
growise.track('Product Viewed', { product_id: 'SKU-1' })
Androidkotlin
GrowWise.logIn("user_123", mapOf("Email" to "a@b.com"))
GrowWise.logEvent("product_viewed", mapOf("item_id" to "SKU-1"))
Flutterdart
await GrowWise.logIn('user_123', {'Email': 'a@b.com'});
await GrowWise.logEvent('product_viewed', {'item_id': 'SKU-1'});

Verify

  • Open Growise live events / debugger
  • Web: Network tab should show /device/register then /track
  • Mobile: Logcat filter GrowWise:* / check dashboard after flush

Next steps

  • Authentication — API keys and environments
  • Identify Users — identity model in depth
  • Track Events — naming and properties
  • Platform SDK pages for push, in-app, and advanced APIs