kobi-pedometer

Step counter module for React Native Expo with background tracking support.

Features

• ✅ Background step counting
• ✅ Persistent notification
• ✅ Real-time updates
• ✅ Date range queries
• ✅ TypeScript support
• ✅ Android 26+ support

Installation

npm install kobi-pedometer
# or
yarn add kobi-pedometer

Configuration

Android Permissions

Add to your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_HEALTH" />

Usage

import {
    initialize,
    requestPermissions,
    getStepsCountAsync,
    setupBackgroundUpdates,
    subscribeToChange,
} from 'kobi-pedometer';

// Initialize
await initialize();

// Request permissions
const permission = await requestPermissions();

// Get today's steps
const steps = await getStepsCountAsync();

// Setup background tracking
await setupBackgroundUpdates({
    title: 'Step Counter',
    contentTemplate: '%d steps today',
});

// Subscribe to updates
const unsubscribe = subscribeToChange(event => {
    console.log(`Steps: ${event.steps}`);
});

// Cleanup
unsubscribe();

API

See API Documentation for full API reference.

License

MIT