@rizwan92/react-native-gymrec

A React Native TurboModule for AI-powered gym exercise recommendations.

Installation

Install the package from npm:

yarn add @rizwan92/react-native-gymrec
# or
npm install @rizwan92/react-native-gymrec --save

Then install iOS pods:

cd ios && pod install && cd ..

React Native 0.60+ supports auto-linking for native modules.

Usage

Import the module and use its async methods:

import {
  listBodyParts,
  listGoals,
  listGenders,
  listLevels,
  listMedicalTags,
  listWeekTags,
  recommendExercises,
  type GymRecInput,
  type ExerciseRec,
} from '@rizwan92/react-native-gymrec';

async function example() {
  // Fetch available options
  const [bodyParts, genders, levels, medicalTags, weekTags, goals] =
    await Promise.all([
      listBodyParts(),
      listGenders(),
      listLevels(),
      listMedicalTags(),
      listWeekTags(),
      listGoals(),
    ]);

  // Prepare input
  const input: GymRecInput = {
    age: 30,
    gender: genders[0],
    weight: 70,
    height: 175,
    goal: goals[0],
    fitness_level: levels[0],
    medical_condition: medicalTags[0],
    week_day: weekTags[0],
    body_parts: [bodyParts[0]],
  };

  // Get recommendations
  const result = await recommendExercises(input);
  const recs: ExerciseRec[] = result.recommendations;
  console.log('Recommendations:', recs);
}

Example App

A complete sample is available at:

packages/example/App.tsx

Open it to see how state is managed, UI is built and how the TurboModule is used end-to-end.

Development

If editing the native Rust model or RN bindings:

1. Rebuild the Rust model and bundle native libraries:

   yarn build:model

2. Re-run pods (iOS) or Gradle (Android) if necessary.
3. Run the example app:

   yarn workspace example react-native run-ios   # or run-android

Publishing

To publish a new version to npm:

1. Ensure the version field in packages/react-native-gymrec/package.json is updated.
2. From the repository root, run:

   yarn publish:gymrec

   This will read the version and publish under @rizwan92 scope with that version tag.

Make sure NPM_TOKEN is set in your environment or CI secrets for authentication.

License

MIT