{"id":34555206,"url":"https://github.com/samshad/mindful-eating-frontend","last_synced_at":"2026-05-28T02:32:52.107Z","repository":{"id":290485135,"uuid":"973959123","full_name":"samshad/mindful-eating-frontend","owner":"samshad","description":"A React Native Expo app that pairs with the Mindful Eating Backend to deliver personalized, AI‑powered mindful‑eating guidance. Users complete a Big Five personality survey, receive daily tips tailored to their dominant trait, log meals with photos, and chat with an interactive coach to build healthier eating habits.","archived":false,"fork":false,"pushed_at":"2025-05-10T04:22:35.000Z","size":36335,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-10T05:23:32.215Z","etag":null,"topics":["expo","react-native"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samshad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-28T03:38:58.000Z","updated_at":"2025-05-10T04:22:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"f90f8de3-58ad-4f6e-9944-6bda6cd2b57a","html_url":"https://github.com/samshad/mindful-eating-frontend","commit_stats":null,"previous_names":["samshad/mindful-eating-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/samshad/mindful-eating-frontend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samshad%2Fmindful-eating-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samshad%2Fmindful-eating-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samshad%2Fmindful-eating-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samshad%2Fmindful-eating-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samshad","download_url":"https://codeload.github.com/samshad/mindful-eating-frontend/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samshad%2Fmindful-eating-frontend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33592074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["expo","react-native"],"created_at":"2025-12-24T08:28:15.475Z","updated_at":"2026-05-28T02:32:52.101Z","avatar_url":"https://github.com/samshad.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mindful Eating Frontend🧘‍♀️🍲\n\n![License](https://img.shields.io/github/license/samshad/mindful-eating-frontend)\n![React Native](https://img.shields.io/badge/React%20Native-0.76.6-blue)\n![Expo](https://img.shields.io/badge/Expo-52.0.0-blue)\n![build](https://img.shields.io/badge/build-passing-brightgreen)\n\n## Overview\n\nThe **Mindful Eating Frontend** is a React Native application built with **Expo** that pairs with the [Mindful Eating Backend](https://github.com/samshad/mindful-eating-backend) to deliver a personalized mindful-eating experience. Users can:\n\n- **Register** and **login** securely.\n- Complete a **Big Five** personality questionnaire.\n- Receive **daily AI-generated** mindful-eating tips tailored to their dominant big5 trait.\n- **Log meals** with photos and review a timeline.\n- **Chat** with the AI coach in an interactive interface.\n- **Manage** their profile details and targeted eating behaviors.\n- Get **network connection** alerts and **custom toast** notifications.\n\n## Features\n\n- **Authentication Flows**  \n  Screens for registration, login, and password reset.\n\n- **Survey \u0026 Onboarding**  \n  Collect basic info and Big Five trait responses.\n\n- **Daily Tips**  \n  AI-powered tips generation with the backend.\n\n- **Meal Logging**  \n  Capture or upload meal images and view in-app timeline.\n\n- **Chat Interface**  \n  Real-time messaging with conversational tips.\n\n- **Profile Management**  \n  View and edit profile, update target behavior.\n\n## Tech Stack\n\n| Category           | Dependencies                                                  |\n|--------------------|---------------------------------------------------------------|\n| Mobile Framework   | React Native · Expo                                           |\n| Navigation         | `@react-navigation/native` · `@react-navigation/native-stack` |\n| State Management   | React Context API                                             |\n| Networking         | Axios (`axios`)                                               |\n| Forms \u0026 Validation | Formik · Yup                                                  |\n| Media Handling     | `expo-image-picker` · `expo-permissions`                      |\n| Storage            | AsyncStorage (`@react-native-async-storage/async-storage`)    |\n| Notifications      | `react-native-toast-message`                                  |\n| Connectivity       | `@react-native-community/netinfo`                            |\n\n## Repository Structure\n\n```\nmindful-eating-frontend/\n├── assets/              # Fonts, images, static assets\n├── component/           # Reusable UI components (Buttons, Inputs, Cards)\n├── screens/             # Screen components for different flows\n│   ├── auth/            # Auth: Register, Login, ForgotPassword\n│   ├── initial/         # Onboarding: Survey, UserProfileSubmission\n│   ├── dashboard/       # Home screen \u0026 ChatScreen\n│   └── profile/         # Profile screens \u0026 behavior update\n├── utils/               # Helper functions (API client, toastConfig)\n├── App.js               # Root navigator \u0026 NetInfo check\n├── index.js             # Expo entry point\n├── app.json             # Expo configuration\n├── eas.json             # EAS build settings\n├── package.json         # Dependencies \u0026 scripts\n└── .gitignore\n```\n\n## Environment Setup\n\n1. **Clone the repo**  \n   ```bash\n   git clone https://github.com/samshad/mindful-eating-frontend.git\n   cd mindful-eating-frontend\n   ```\n\n2. **Install dependencies**  \n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. **Configure environment**\n   Create or update the `utils/config.js` file with your backend API URL.\n   It should look something like this:\n\n    ```javascript\n   // utils/config.js\n   export const BASE_URL = 'https://your-backend-api-url.com/api/v1'; // Replace with your actual backend URL\n   // Add other global configurations here if needed\n    ```\n## Running the App\n\nLaunch the Expo development server:\n```bash\nnpx expo start -c\n```\n- Press `i` to open on iOS simulator.\n- Press `a` to open on Android emulator.\n- Scan the QR code with Expo Go on mobile devices.\n\n## Scripts\n\n| Command         | Description                          |\n|-----------------|--------------------------------------|\n| `expo start`    | Start Metro bundler                  |\n| `expo build`    | Build standalone binaries (legacy)   |\n| `eas build`     | Run EAS build for iOS \u0026 Android      |\n| `npm run lint`  | Lint codebase (if configured)        |\n| `npm test`      | Run tests (if any are added)         |\n\n## Contributing\n\n1. Fork the repository.\n2. Create a feature branch: `git checkout -b feature/my-feature`\n3. Commit changes: `git commit -m \"Add my feature\"`\n4. Push branch: `git push origin feature/my-feature`\n5. Open a Pull Request and describe your changes.\n\n## Acknowledgements\n\nThis project was undertaken as a research project for my Master of Applied Computer Science program at Persuasive Computing Lab, Dalhousie University.\n\n**Supervisors:** Dr. Rita Orji \u0026 Dr. Oladapo Oyebode\n\n## Companion Backend Service\nThis frontend application communicates with the **Mindful Eating Backend** for data persistence, AI-powered tip generation, and business logic.\n- **Backend Repository:** [samshad/mindful-eating-backend](https://github.com/samshad/mindful-eating-backend)\n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0.  \nSee the [LICENSE](LICENSE) file for details.  \n© 2025 Md Samshad Rahman (Persuasive Computing Lab, Dalhousie University)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamshad%2Fmindful-eating-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamshad%2Fmindful-eating-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamshad%2Fmindful-eating-frontend/lists"}