Smart Grow Logs Plugin for Flutter #

A Flutter plugin for secure logging with end-to-end encryption.

Features #

• 🔒 End-to-end encrypted logging
• 📱 Native implementations for iOS and Android
• 🚀 Simple, intuitive API
• 📊 Multiple log levels (debug, info, warn, error, fatal)
• 🔄 Automatic device info detection

Prerequisites #

Before using this plugin, you need to:

1. Sign up for a free account at logs.smart-grow.app
2. Create a new project in the dashboard
3. Get your API key from the project settings

The plugin requires an active Smart Grow Logs account to function. All logs are securely transmitted to your Smart Grow Logs dashboard.

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  smart_grow_logs_plugin: ^1.0.0

Then run:

flutter pub get

Usage #

Initialize the SDK #

Call this once at app startup:

import 'package:smart_grow_logs_plugin/smart_grow_logs_plugin.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await SmartGrowLogs.initialize(
    apiKey: 'sgl_your_api_key',
    baseUrl: 'https://logs-api.smart-grow.app/',
  );
  
  runApp(MyApp());
}

Send Logs #

Use the convenience methods:

final logs = SmartGrowLogs.instance;

// Debug log
await logs.logDebug('Application started');

// Info log with metadata
await logs.info(
  'User logged in',
  metadata: '{"userId": "123", "method": "google"}',
  userIdentifier: 'user@example.com',
);

// Warning log
await logs.warn('Deprecated API usage detected');

// Error log with stack trace
try {
  // some code that might throw
} catch (e, stackTrace) {
  await logs.errorWithException(
    'Failed to process data',
    e,
    stackTrace: stackTrace,
    metadata: '{"operation": "data_processing"}',
  );
}

// Fatal log
await logs.fatal(
  'Critical system failure',
  stackTrace: StackTrace.current.toString(),
);

Log Levels #

Full LogOptions #

For more control, use sendLog directly:

final response = await SmartGrowLogs.instance.sendLog(LogOptions(
  level: LogLevel.error,
  message: 'Payment failed',
  stackTrace: stackTrace.toString(),
  metadata: '{"orderId": "ORD-123", "amount": 99.99}',
  userIdentifier: 'user@example.com',
  sessionId: 'session-abc-123',
));

if (response.success) {
  print('Log sent successfully: ${response.logId}');
} else {
  print('Failed to send log: ${response.error}');
}

API Reference #

SmartGrowLogs #

LogOptions #

LogResponse #

Minimum Requirements #

• Flutter: 3.3.0+
• Dart: 3.0.0+
• iOS: 15.0+
• Android: API 26+ (Android 8.0)

License #

Proprietary - Smart Dev Agency