Inspiration:

Working out consistently is one of the hardest habits to maintain, especially when doing it alone. We were inspired by the power of accountability and community in fitness. Research shows that people are 65% more likely to achieve their goals when they share them with others. We wanted to create a solution that combines the social aspect of fitness with modern technology - specifically designed for small, intimate groups of 2-5 friends who can truly hold each other accountable without the overwhelming noise of large fitness communities.

What it does:

GymBro is a fitness accountability app that helps small groups of friends stay consistent with their workouts through:

  • Daily Check-ins: Users can post photo or text updates of their workouts
  • Streak Tracking: Visual progress tracking that gamifies consistency
    • AI-Powered Motivation: Personalized encouragement messages generated using Google Gemini AI
    • Group Management: Create or join workout groups with unique invite codes
    • Push Notifications: Gentle reminders and motivational messages
    • Social Feed: See your group members' progress and celebrate wins together
    • Voice Motivation: Text-to-speech motivational messages using ElevenLabs AI

The app focuses on small, tight-knit groups rather than large social networks, making accountability more personal and effective.

How we built it:

We built GymBro as a full-stack mobile application using modern cloud-native technologies:

Frontend (Mobile App):

  • React Native with Expo for cross-platform development
  • TypeScript for type safety
  • NativeWind (TailwindCSS) for styling
  • Zustand for state management
  • TanStack React Query for server state
  • Supabase for authentication
  • Backend (API & Infrastructure):
  • Cloudflare Workers for serverless edge computing
  • Hono framework for lightweight API routing
  • Cloudflare D1 (SQLite) for database
  • Cloudflare R2 for image storage
  • Cloudflare KV for caching

AI Integration:

  • Google Gemini API for motivational message generation
  • ElevenLabs API for text-to-speech conversion
  • OpenRouter as AI service fallback

Key Features:

  • Real-time push notifications
  • Image upload and processing
  • Automated daily streak calculations
  • Cron jobs for daily motivational messages
  • JWT-based authentication with Supabase

Challenges we ran into:

  • Authentication Complexity: Integrating Supabase auth with our custom Cloudflare Workers backend required careful token management and user linking between systems.
  • Real-time Updates: Implementing push notifications across iOS and Android while maintaining a seamless user experience was challenging, especially with the different notification systems.
  • AI Integration: Getting consistent, high-quality motivational messages from AI services required extensive prompt engineering and fallback mechanisms.
  • Image Handling: Managing image uploads, processing, and storage across Cloudflare R2 while maintaining good performance on mobile devices.
  • State Management: Coordinating between local state (Zustand), server state (React Query), and authentication state across the app.
  • Edge Computing Learning Curve: Adapting to Cloudflare Workers' serverless model and understanding the limitations of the edge runtime.

Accomplishments that we're proud of:

  • Complete Full-Stack Solution: Built a production-ready app with authentication, database, file storage, and AI integration
  • Modern Architecture: Implemented a serverless, edge-first architecture that scales globally
  • AI Innovation: Successfully integrated multiple AI services for both text generation and voice synthesis
  • Cross-Platform: Single codebase that works seamlessly on iOS, Android, and web
  • Performance: Sub-second API responses thanks to Cloudflare's global edge network
  • User Experience: Intuitive interface with smooth animations and haptic feedback
  • Scalable Database Design: Well-structured SQLite schema with proper indexing and relationships What we learned
  • Serverless Architecture: Deep dive into Cloudflare Workers and how to build efficient serverless applications
  • Mobile Development: Advanced React Native patterns, especially around state management and navigation
  • AI Integration: How to effectively integrate multiple AI services and handle their limitations
  • Database Design: Designing efficient schemas for social features like groups, posts, and streaks Authentication Patterns: JWT token management and user synchronization across multiple services
  • Edge Computing: The benefits and challenges of running code at the edge vs traditional servers
  • Team Collaboration: Working with modern development tools and cloud services

What's next for GymBro

  • Voice Messages: Allow users to record and share voice updates with their groups
  • Custom Voice Motivation Clips: Motivational voice recordings of friends or AI voice clips of your favorite fictional characters can be played instead of the default voice.
  • Workout Plans: Share and follow structured workout routines within groups
  • Fitness Tracker Integration: Connect with Apple Health, Google Fit, and wearable devices
  • Advanced Analytics: Detailed progress tracking with charts and insights
  • Group Challenges: Create custom challenges and competitions within groups
  • Meal Planning: Integrate nutrition tracking and meal planning features
  • Achievement System: Badges and milestones to gamify the fitness journey
  • Social Features: Add likes, comments, and reactions to posts
  • Export Data: Allow users to export their fitness data and progress
  • Web Dashboard: Full web interface for managing groups and viewing analytics
  • API for Third-Party Apps: Open API for fitness app integrations

We're excited to continue developing GymBro into a comprehensive fitness accountability platform that helps people build lasting healthy habits through the power of community and technology.

Built With

Share this project:

Updates