FT SDK - Fitness Tracking SDK for React Native

A complete, production-ready React Native SDK for fitness tracking with full UI and logic. Track steps, sleep, nutrition, and scan food items with a beautiful, modern interface.

📦 Installation

Step 1: Install SDK

npm install ft-sdk

Step 2: Install Missing Peer Dependencies

⚠️ CRITICAL: Install only the dependencies that are missing from your project.

The SDK accepts ANY version of peer dependencies - it works with whatever versions your app already has!

Check which packages you're missing and install only those:

# Most common missing packages:
npm install \
  @react-navigation/native-stack \
  react-native-calendars \
  victory-native \
  @shopify/react-native-skia

If your app doesn't have others, install them too (SDK will use your existing versions):

npm install \
  @react-navigation/native \
  @react-navigation/bottom-tabs \
  react-native-screens \
  react-native-gesture-handler \
  react-native-reanimated \
  react-native-vision-camera \
  react-native-svg \
  @react-native-async-storage/async-storage \
  react-native-permissions \
  react-native-safe-area-context

✅ The SDK accepts ALL versions - no version conflicts, works with any React Native version!

🚀 Quick Start

import React from 'react';
import FitRoot from 'ft-sdk';

function App() {
  return (
    <FitRoot 
      userToken="your-user-token"
      theme="light"
      enableFoodScan={true}
    />
  );
}

export default App;

📱 Features

• ✅ Onboarding Flow - Welcome screens with health permissions
• ✅ Dashboard - Real-time stats with circular progress indicators
• ✅ Food Scanner - Camera-based food recognition
• ✅ Monthly Reports - Interactive charts for 30-day trends
• ✅ Nutrition Calendar - Visual meal tracking calendar
• ✅ Light/Dark Theme - Automatic theme support
• ✅ TypeScript - Fully typed

🔧 Setup

iOS

cd ios
pod install
cd ..

Android

No additional setup required. The SDK uses React Native's autolinking.

📚 API

FitRoot Props

interface FitSDKProps {
  userToken: string;           // Required: User authentication token
  theme?: "light" | "dark";    // Optional: Theme override (defaults to system)
  enableFoodScan?: boolean;     // Optional: Enable food scanning (default: true)
}

🎨 Usage Examples

Basic Usage

import FitRoot from 'ft-sdk';

<FitRoot userToken="abc123" />

With Theme

<FitRoot 
  userToken="abc123" 
  theme="dark"
/>

Disable Food Scanner

<FitRoot 
  userToken="abc123" 
  enableFoodScan={false}
/>

📋 Requirements

• React Native >= 0.70.0
• React >= 18.0.0
• iOS 13+ / Android API 24+

🔌 Dependencies

The SDK includes the following peer dependencies (install them in your app):

• @react-navigation/native
• @react-navigation/native-stack
• @react-navigation/bottom-tabs
• react-native-screens
• react-native-gesture-handler
• react-native-reanimated
• react-native-safe-area-context
• @react-native-async-storage/async-storage

📖 Documentation

See the full documentation for detailed usage instructions.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT

🔗 Links

• GitHub Repository
• npm Package