# 🌿 SoulSync – AI Mood Companion

**SoulSync** is a privacy-first, AI-powered emotional wellness companion. Track your mood, get daily affirmations from Gemini AI, practice mindfulness, and grow emotionally—without ever signing in. Your data stays with you.

🔗 [Live App](https://soulsync.rabinchudali07.xyz)

---

## ✨ Features

- 🎯 **Mood Tracker** – Log your emotions using a calming emoji-based interface.
- 🤖 **AI Affirmations** – Personalized quotes using Google Gemini.
- 🧘 **Mindfulness Exercises** – Breathing, grounding, body scan, and more.
- 📔 **Private Journaling** – Data stored locally; no accounts, no cloud.
- 📈 **Progress Insights** – View your mood trends visually.
- 🔐 **Privacy Focused** – Zero tracking, zero data sharing.

---

## 🛠️ Tech Stack

- **React.js** – UI development
- **Tailwind CSS** – Styling
- **Google Gemini API** – AI affirmations
- **LocalStorage API** – Client-side journal + mood data
- **Chart.js** – Progress visualization

---

## 📦 Getting Started

### Prerequisites

- Node.js v18+
- npm or yarn

### Setup Instructions

```bash
git clone https://github.com/technophile-cracker/soulsync.git
cd soulsync
npm install
npm run dev
```

Then open: `http://localhost:3000`

---

## 🔐 Environment Variables

Create a `.env` file in the root directory:

```env
GEMINI_API_KEY=your_gemini_api_key
```

Make sure **not** to push `.env` to GitHub.

---

## 📁 Project Structure

```
src/
├── components/       # UI components
├── pages/            # Main routes
├── utils/            # Helper functions
├── data/             # Mood presets
└── assets/           # Icons and media
```

---

## 🙋 Author

**Rabin Chudali**  
Lead Developer & Gemini Integration  
GitHub: [@technophile-cracker](https://github.com/technophile-cracker)  
Email: rabinchudali07@gmail.com

---

## 📜 License

MIT License © 2025 – Rabin Chudali

---

> “SoulSync is built on one belief: mental wellness should be personal, private, and peaceful.” 🧘