Skip to content

Basketic-2025/FITNESS-APP

Repository files navigation

FitLite – AI-Powered Fitness Companion

FitLite is an Expo/React Native mobile app that helps athletes stay on track with curated training plans, beautiful progress tracking, and lightning-fast logging tools. This build ships with a polished, senior-level UI, full demo content, and rock-solid state persistence so you can explore every flow right away.

✨ Highlights

  • Responsive visual design – peach-toned gradients, frosted cards, and polished typography (Inter) that adapts across iOS/Android.
  • Preloaded content – curated exercises, five ready-to-run workouts, and two training plans so the app feels alive on first launch.
  • Stateful experience – hydration/streak data, workout history, and achievements persist via AsyncStorage + debounced file backup.
  • Powerful navigation – typed stack + tab navigators, global search modal, and modular plan builder for quick expansion.
  • Notifications ready – hydration/workout reminders wired through Expo Notifications with Expo Go–safe guards.
  • Testing scaffolded – Jest config, calc utility tests, and mocks for Expo modules provide a baseline for future coverage.

🚀 Quick Start

npm install
npx expo start

Tip: Use npx expo start -c after pulling to clear any stale Metro caches.

🧱 Project Structure

  • App.tsx – gesture/safe-area wrapper, font loading, hero background.
  • src/navigation – typed root/tab/workout stacks, floating tab bar, search header.
  • src/screens – Home dashboard, rich onboarding, plan builder, detailed workout flows.
  • src/state/useStore.ts – Zustand store with persistence, streak logic, plan actions.
  • assets/db/app.seed.json – seed data (exercises, workouts, plans, logs, achievements).
  • src/theme – design tokens, gradients, font families, navigation theme helper.

📱 Feature Tour

  • Home dashboard – Daily performance rings, quick actions, streak stats, recent workouts.
  • Global search – Gradient CTA opens a modal for instant workout/exercise lookup.
  • Plan builder – Full-screen editor with day-by-day assignments, notes, and workout picker.
  • Workout logging – Guided Start Workout screen with timers, volume calc, PR updates.
  • Quick log – Log water, steps, and weight with presets and running totals.
  • Progress – Personal records list with chart placeholders ready for Victory charts.
  • Settings – Theme/unit toggles, goal editing, JSON import/export, notification controls.

🔔 Notifications

Expo Go can’t receive remote push tokens, but the scheduling logic is in src/notifications/schedule.ts. Development builds will schedule weekly workout reminders and daily hydration nudges once permissions are granted.

🧪 Testing

npm run test

Jest is configured with expo-safe mocks (jest-setup.ts) and calc utility coverage. Extend with React Native Testing Library as you iterate.

🗺️ Roadmap Ideas

  • Reinstate animated Victory charts once Reanimated config is resolved.
  • Build profile editing, metrics export, and richer plan templates.
  • Layer on social/accountability features (shared plans, streak competitions).

📄 License

MIT © Basketic-2025 — Fitness mobile app built by AI.

About

Fitness mobile app built by ai

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors