From 7b0e1291a075bb4716e434872e1cb0acfa45ad9d Mon Sep 17 00:00:00 2001 From: medhini98 <59174666+medhini98@users.noreply.github.com> Date: Tue, 5 Aug 2025 22:37:07 +0530 Subject: [PATCH 1/3] Create cycle-sync-ai.mdx --- docs/showcase/cycle-sync-ai.mdx | 109 ++++++++++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 docs/showcase/cycle-sync-ai.mdx diff --git a/docs/showcase/cycle-sync-ai.mdx b/docs/showcase/cycle-sync-ai.mdx new file mode 100644 index 0000000..8306a22 --- /dev/null +++ b/docs/showcase/cycle-sync-ai.mdx @@ -0,0 +1,109 @@ +# CycleSyncAI: Personalized Health Plans Powered by Sonar API + +## πŸš€ Overview + +**CycleSyncAI** is an iOS app designed to provide personalized **diet and workout recommendations** tailored to a woman’s **menstrual cycle phase**. + +By integrating menstrual data from Apple **HealthKit** and optional user profile inputs (age, weight, height, medical conditions, dietary restrictions, goals, and preferences), the app generates dynamic, phase-aware suggestions to support holistic wellness. + +Unlike static wellness tools, **CycleSyncAI** leverages **Perplexity’s Sonar Pro API** to deliver **expert-informed**, LLM-generated guidance β€” including a daily grocery list and motivational feedback β€” customized to the user's cycle and lifestyle. + +--- + +## 🧠 Problem & Solution + +> **Why it matters:** +Most apps overlook the hormonal changes that affect women’s fitness and nutrition needs across their cycle, leaving users with generic advice. + +**CycleSyncAI** bridges this gap by combining Apple HealthKit data with Sonar Pro’s LLM to generate **adaptive, cycle-aware recommendations** for better health outcomes. + +--- + +## ✨ Features + +- βœ… **Personalized diet & workout suggestions** per cycle phase +- πŸ”„ Syncs with Apple HealthKit for real-time cycle tracking +- πŸ‘€ User profile inputs for advanced personalization (age, goals, restrictions, etc.) +- πŸ›’ **Auto-generated daily grocery list** +- 🎨 Smooth, modern UI with gradients and subtle animations +- πŸ’¬ **Motivational AI feedback** tailored to user preferences +- πŸ”’ Local data storage and private processing + +--- + +## πŸ’‘ Motivation + +> β€œI wanted a tailored regime for myself and couldn’t find it all in one place.” + +**CycleSyncAI** was born from the need for a science-backed, easy-to-use app that adapts wellness guidance to women’s natural hormonal rhythms, something missing in most mainstream fitness and nutrition platforms. + +--- + +## πŸ› οΈ Repository Structure +CycleSyncAI.xcodeproj β†’ Xcode project file +CycleSyncAI/ β†’ Source code +β”œβ”€β”€ EatPlanViewController.swift β†’ Diet plan generation & display +β”œβ”€β”€ WorkoutPlanViewController.swift β†’ Workout plan generation & display +β”œβ”€β”€ HomepageViewController.swift β†’ Navigation & main screen +β”œβ”€β”€ UserProfileViewController.swift β†’ Input & storage of user data +β”œβ”€β”€ HealthManager.swift β†’ Apple HealthKit menstrual data +β”œβ”€β”€ UserProfile.swift β†’ Local profile model +Main.storyboard β†’ App UI & layout +Assets.xcassets β†’ Images & app icons +Info.plist β†’ Permissions & configurations + +--- + +## πŸ”§ Setup Instructions + +1. Clone the repo +2. Open in **Xcode** +3. Ensure Apple HealthKit is enabled on your device +4. Insert your **Sonar Pro API key** +5. Run the app on a physical device (recommended) + +--- + +## 🧬 Sonar API Usage + +The app sends structured prompts to the **Sonar Pro API** including: + +- Cycle phase (from HealthKit) +- User profile info (age, weight, goals, etc.) +- Meal preferences & restrictions + +In return, it receives: + +- βœ… **Personalized diet plan** +- βœ… **Custom workout plan** +- βœ… **Daily grocery list** +- βœ… **Motivational feedback** + +These are parsed and rendered as styled HTML inside the app using WebViews. + +--- + +## πŸŽ₯ Demo Video + +Watch the full app walkthrough here: https://www.youtube.com/watch?v=R558uRLNvUM&t=2s. + +> *Note: The LLM takes ~30–60 seconds per request. This wait time was trimmed in the video for brevity.* + +--- + +## βœ… Impact + +**CycleSyncAI** empowers women to make informed, body-aware decisions in daily life. The app supports better: + +- Energy management +- Fitness results +- Mental well-being +- Motivation and confidence + +It also reduces decision fatigue with automatically prepared grocery lists and uplifting guidance. + +--- + +## πŸ”— Links + +- [GitHub Repository](https://github.com/medhini98/cyclesyncai-api-cookbook) From 2fe9f7556c7df3161241bcf1ad7232dafdc658f2 Mon Sep 17 00:00:00 2001 From: Kesku Date: Tue, 5 Aug 2025 18:47:05 +0100 Subject: [PATCH 2/3] add frontmatter --- docs/showcase/cycle-sync-ai.mdx | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/docs/showcase/cycle-sync-ai.mdx b/docs/showcase/cycle-sync-ai.mdx index 8306a22..9e9d274 100644 --- a/docs/showcase/cycle-sync-ai.mdx +++ b/docs/showcase/cycle-sync-ai.mdx @@ -1,3 +1,10 @@ +--- +title: CycleSyncAI: Personalized Health Plans Powered by Sonar API +description: iOS app that delivers personalized diet and workout recommendations for women, powered by Apple HealthKit and Perplexity’s Sonar Pro API. +sidebar_position: 7 +keywords: [CycleSyncAI, Sonar API, Perplexity, HealthKit, iOS, menstrual cycle, fitness, nutrition, LLM, AI, wellness, personalized, app] +--- + # CycleSyncAI: Personalized Health Plans Powered by Sonar API ## πŸš€ Overview @@ -40,17 +47,18 @@ Most apps overlook the hormonal changes that affect women’s fitness and nutrit --- ## πŸ› οΈ Repository Structure -CycleSyncAI.xcodeproj β†’ Xcode project file -CycleSyncAI/ β†’ Source code -β”œβ”€β”€ EatPlanViewController.swift β†’ Diet plan generation & display -β”œβ”€β”€ WorkoutPlanViewController.swift β†’ Workout plan generation & display -β”œβ”€β”€ HomepageViewController.swift β†’ Navigation & main screen -β”œβ”€β”€ UserProfileViewController.swift β†’ Input & storage of user data -β”œβ”€β”€ HealthManager.swift β†’ Apple HealthKit menstrual data -β”œβ”€β”€ UserProfile.swift β†’ Local profile model -Main.storyboard β†’ App UI & layout -Assets.xcassets β†’ Images & app icons -Info.plist β†’ Permissions & configurations + +CycleSyncAI.xcodeproj β†’ Xcode project file +CycleSyncAI/ β†’ Source code +β”œβ”€β”€ EatPlanViewController.swift β†’ Diet plan generation & display +β”œβ”€β”€ WorkoutPlanViewController.swift β†’ Workout plan generation & display +β”œβ”€β”€ HomepageViewController.swift β†’ Navigation & main screen +β”œβ”€β”€ UserProfileViewController.swift β†’ Input & storage of user data +β”œβ”€β”€ HealthManager.swift β†’ Apple HealthKit menstrual data +β”œβ”€β”€ UserProfile.swift β†’ Local profile model +Main.storyboard β†’ App UI & layout +Assets.xcassets β†’ Images & app icons +Info.plist β†’ Permissions & configurations --- From ad3f90353eedec009c249bd31f99e9c0482af5aa Mon Sep 17 00:00:00 2001 From: Kesku Date: Tue, 5 Aug 2025 18:51:13 +0100 Subject: [PATCH 3/3] docs: standardize showcase format --- docs/showcase/cycle-sync-ai.mdx | 96 +++++++++++++-------------------- 1 file changed, 38 insertions(+), 58 deletions(-) diff --git a/docs/showcase/cycle-sync-ai.mdx b/docs/showcase/cycle-sync-ai.mdx index 9e9d274..7296d66 100644 --- a/docs/showcase/cycle-sync-ai.mdx +++ b/docs/showcase/cycle-sync-ai.mdx @@ -1,53 +1,42 @@ --- -title: CycleSyncAI: Personalized Health Plans Powered by Sonar API -description: iOS app that delivers personalized diet and workout recommendations for women, powered by Apple HealthKit and Perplexity’s Sonar Pro API. +title: CycleSyncAI | Personalized Health Plans Powered by Sonar API +description: iOS app that delivers personalized diet and workout recommendations for women, powered by Apple HealthKit and Perplexity's Sonar Pro API. sidebar_position: 7 keywords: [CycleSyncAI, Sonar API, Perplexity, HealthKit, iOS, menstrual cycle, fitness, nutrition, LLM, AI, wellness, personalized, app] --- -# CycleSyncAI: Personalized Health Plans Powered by Sonar API - -## πŸš€ Overview - -**CycleSyncAI** is an iOS app designed to provide personalized **diet and workout recommendations** tailored to a woman’s **menstrual cycle phase**. +**CycleSyncAI** is an iOS app designed to provide personalized **diet and workout recommendations** tailored to a woman's **menstrual cycle phase**. By integrating menstrual data from Apple **HealthKit** and optional user profile inputs (age, weight, height, medical conditions, dietary restrictions, goals, and preferences), the app generates dynamic, phase-aware suggestions to support holistic wellness. -Unlike static wellness tools, **CycleSyncAI** leverages **Perplexity’s Sonar Pro API** to deliver **expert-informed**, LLM-generated guidance β€” including a daily grocery list and motivational feedback β€” customized to the user's cycle and lifestyle. +Unlike static wellness tools, **CycleSyncAI** leverages **Perplexity's Sonar Pro API** to deliver **expert-informed**, LLM-generated guidance β€” including a daily grocery list and motivational feedback β€” customized to the user's cycle and lifestyle. ---- - -## 🧠 Problem & Solution +## Problem & Solution > **Why it matters:** -Most apps overlook the hormonal changes that affect women’s fitness and nutrition needs across their cycle, leaving users with generic advice. - -**CycleSyncAI** bridges this gap by combining Apple HealthKit data with Sonar Pro’s LLM to generate **adaptive, cycle-aware recommendations** for better health outcomes. +Most apps overlook the hormonal changes that affect women's fitness and nutrition needs across their cycle, leaving users with generic advice. ---- - -## ✨ Features +**CycleSyncAI** bridges this gap by combining Apple HealthKit data with Sonar Pro's LLM to generate **adaptive, cycle-aware recommendations** for better health outcomes. -- βœ… **Personalized diet & workout suggestions** per cycle phase -- πŸ”„ Syncs with Apple HealthKit for real-time cycle tracking -- πŸ‘€ User profile inputs for advanced personalization (age, goals, restrictions, etc.) -- πŸ›’ **Auto-generated daily grocery list** -- 🎨 Smooth, modern UI with gradients and subtle animations -- πŸ’¬ **Motivational AI feedback** tailored to user preferences -- πŸ”’ Local data storage and private processing +## Features ---- +* **Personalized diet & workout suggestions** per cycle phase +* Syncs with Apple HealthKit for real-time cycle tracking +* User profile inputs for advanced personalization (age, goals, restrictions, etc.) +* **Auto-generated daily grocery list** +* Smooth, modern UI with gradients and subtle animations +* **Motivational AI feedback** tailored to user preferences +* Local data storage and private processing -## πŸ’‘ Motivation +## Motivation -> β€œI wanted a tailored regime for myself and couldn’t find it all in one place.” +> "I wanted a tailored regime for myself and couldn't find it all in one place." -**CycleSyncAI** was born from the need for a science-backed, easy-to-use app that adapts wellness guidance to women’s natural hormonal rhythms, something missing in most mainstream fitness and nutrition platforms. - ---- +**CycleSyncAI** was born from the need for a science-backed, easy-to-use app that adapts wellness guidance to women's natural hormonal rhythms, something missing in most mainstream fitness and nutrition platforms. -## πŸ› οΈ Repository Structure +## Repository Structure +``` CycleSyncAI.xcodeproj β†’ Xcode project file CycleSyncAI/ β†’ Source code β”œβ”€β”€ EatPlanViewController.swift β†’ Diet plan generation & display @@ -59,10 +48,9 @@ CycleSyncAI/ β†’ Source code Main.storyboard β†’ App UI & layout Assets.xcassets β†’ Images & app icons Info.plist β†’ Permissions & configurations +``` ---- - -## πŸ”§ Setup Instructions +## Setup Instructions 1. Clone the repo 2. Open in **Xcode** @@ -70,48 +58,40 @@ Info.plist β†’ Permissions & configurations 4. Insert your **Sonar Pro API key** 5. Run the app on a physical device (recommended) ---- - -## 🧬 Sonar API Usage +## Sonar API Usage The app sends structured prompts to the **Sonar Pro API** including: -- Cycle phase (from HealthKit) -- User profile info (age, weight, goals, etc.) -- Meal preferences & restrictions +* Cycle phase (from HealthKit) +* User profile info (age, weight, goals, etc.) +* Meal preferences & restrictions In return, it receives: -- βœ… **Personalized diet plan** -- βœ… **Custom workout plan** -- βœ… **Daily grocery list** -- βœ… **Motivational feedback** +* **Personalized diet plan** +* **Custom workout plan** +* **Daily grocery list** +* **Motivational feedback** These are parsed and rendered as styled HTML inside the app using WebViews. ---- - -## πŸŽ₯ Demo Video +## Demo Video Watch the full app walkthrough here: https://www.youtube.com/watch?v=R558uRLNvUM&t=2s. > *Note: The LLM takes ~30–60 seconds per request. This wait time was trimmed in the video for brevity.* ---- - -## βœ… Impact +## Impact **CycleSyncAI** empowers women to make informed, body-aware decisions in daily life. The app supports better: -- Energy management -- Fitness results -- Mental well-being -- Motivation and confidence +* Energy management +* Fitness results +* Mental well-being +* Motivation and confidence It also reduces decision fatigue with automatically prepared grocery lists and uplifting guidance. ---- - -## πŸ”— Links +## Links -- [GitHub Repository](https://github.com/medhini98/cyclesyncai-api-cookbook) +* [GitHub Repository](https://github.com/medhini98/cyclesyncai-api-cookbook)