## 🎃 Hacktoberfest 2025
This repository is participating in **Hacktoberfest 2025**! Don't forget to Star ⭐️ the Repo and show your support!

# 🍽️ DineFit

**Personalized recipe discovery platform**

DineFit is a smart, user-friendly web application designed to help individuals discover recipes that align with their unique diet preferences. The platform empowers users to receive real, cookable recipe suggestions sourced from trusted online databases, based on their preferences, likes and dislikes! Don't know what to cook? Let DineFit decide!

![DineFit Dashboard](https://img.shields.io/badge/Status-Production%20Ready-green)
![React](https://img.shields.io/badge/React-19+-blue)
![Vite](https://img.shields.io/badge/Vite-7.0-purple)
![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3.4+-teal)

## 🏗️ Tech Stack

### **Frontend**
- **React 19.1.0** - Modern hooks-based architecture
- **Vite 7.0** - Lightning-fast development and build
- **TailwindCSS 3.4+** - Utility-first styling with glass morphism

### **Backend & Services**
- **Appwrite 18.1.1** - Authentication and user profiles
- **Spoonacular API** - Premium recipe database with dietary filtering
- **NodeCache** - In-memory caching for performance optimization

## 🚀 Getting Started

Follow these steps to run DineFit on your local machine:

1. **Clone the repository**
   ```sh
   git clone https://github.com/imkrishnasarathi/DineFit.git
   ```

2. **Navigate into the project folder**
   ```sh
   cd DineFit
   ```

3. **Install dependencies**
   ```sh
   npm install
   ```

4. **Start the development server**
   ```sh
   npm run dev
   ```

After running the command, you should see output similar to:

```
  VITE v7.x.x  ready in xxxx ms

  ➜  Local:   http://localhost:5173/
```

Now open your browser at [http://localhost:5173/](http://localhost:5173/) to view the app.

## 🔄 Development Roadmap

### ✅ **Completed**
- [x] User authentication system
- [x] Responsive dashboard design
- [x] Meal logging interface
- [x] Basic nutrition tracking
- [x] Weight goal management
- [x] Recipe API integration

### 🚧 **In Progress**
- [ ] Meal planning features

### 📋 **Planned Features**
- [ ] Social sharing capabilities
- [ ] Weekly meal planning
- [ ] Grocery list generation
- [ ] Progress analytics and insights

## 🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

### Contributing Guidelines
We welcome contributions — whether it’s bug fixes, documentation, or new features.  
Check out [CONTRIBUTING.md](./CONTRIBUTING.md) to get started.

## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.