https://github.com/mootseeker/cutmate
Your AI wingman for weight loss. CutMate helps men achieve their cutting goals through personalized AI meal recommendations, progress tracking, and motivational support all with a friendly, no-pressure approach.
https://github.com/mootseeker/cutmate
ai-integration authentication ci-cd-pipeline cross-platform documentation firebase-integration flutter localization performance-analysis postgresql restful-api security-implementation state-management
Last synced: 12 months ago
JSON representation
Your AI wingman for weight loss. CutMate helps men achieve their cutting goals through personalized AI meal recommendations, progress tracking, and motivational support all with a friendly, no-pressure approach.
- Host: GitHub
- URL: https://github.com/mootseeker/cutmate
- Owner: MootSeeker
- License: mit
- Created: 2025-05-27T10:23:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-13T13:25:56.000Z (about 1 year ago)
- Last Synced: 2025-06-13T14:42:07.516Z (about 1 year ago)
- Topics: ai-integration, authentication, ci-cd-pipeline, cross-platform, documentation, firebase-integration, flutter, localization, performance-analysis, postgresql, restful-api, security-implementation, state-management
- Language: Dart
- Homepage:
- Size: 12.3 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# CutMate
CutMate is an AI-powered weight loss application primarily for males aged 18-35. The app features personalized goal setting, progress tracking, AI-generated meal suggestions, and shareable visuals with a focus on habit-building and creating viral shareable content.
## Features
- **Personalized Goal Setting**: Set your target weight and timeframe
- **Weight Tracking**: Log your weight daily with optional notes
- **Progress Visualization**: View your weight loss journey through intuitive charts
- **AI Meal Recommendations**: Get meal suggestions tailored to your preferences, available ingredients, and dietary goals using Mistral-7B AI model
- **Shareable Content**: Create and share meal cards and milestone achievements
## Project Status
### Implemented
- ✅ Project structure setup
- ✅ Theme implementation based on brand guidelines
- ✅ App navigation with bottom tab bar
- ✅ Weight entry screen with form validation
- ✅ Weight data persistence using local storage
- ✅ Progress visualization with charts
- ✅ Home screen with key feature cards
### In Progress
- ✅ Meal recommendation features with AI integration
- ✅ Project structure consolidation and cleanup
- 🔄 User profile management
- 🔄 Shareable content generation
### Pending
- 📝 Social sharing capabilities
- 📝 Integration with fitness tracking APIs
- 📝 Unit and integration tests
## Technology Stack
- **Framework**: Flutter
- **State Management**: Provider
- **Storage**: SharedPreferences
- **Charts**: fl_chart
- **UI Components**: Material Design
- **AI Integration**: Integration with external AI models for meal recommendations
## Project Structure
The project follows a clean architecture approach with the following key components:
- **Models**: Data structures representing core business entities
- **Services**: Business logic and data management
- `meal_service.dart`: Consolidated service for AI-powered meal recommendations
- `meal_provider.dart`: State management for meal-related features
- `weight_provider.dart`: Handles weight tracking functionality
- `settings_provider.dart`: Manages app settings and preferences
- **Screens**: UI components for different app sections
- **Widgets**: Reusable UI components
- **Constants**: App-wide configuration values
- **Theme**: Styling and visual appearance definitions
## Getting Started
### Prerequisites
- Flutter SDK (version 3.x or higher)
- Android Studio or VS Code with Flutter extensions
- Android or iOS device/emulator
### Installation
1. Clone the repository
```bash
git clone https://github.com/yourusername/cutmate.git
```
2. Install dependencies
```bash
flutter pub get
```
3. Run the app
```bash
flutter run
```