https://github.com/mariarodr1136/ecohabittracker
EcoHabit Tracker is a fun iOS app that helps kids develop sustainable habits through gamification, challenges, and educational tips. By learning how their actions can positively impact the environment, kids become eco-heroes!
https://github.com/mariarodr1136/ecohabittracker
children-games ecosystem environmental gamification habit-tracking ios ios-app ios-swift swift swiftui
Last synced: 6 months ago
JSON representation
EcoHabit Tracker is a fun iOS app that helps kids develop sustainable habits through gamification, challenges, and educational tips. By learning how their actions can positively impact the environment, kids become eco-heroes!
- Host: GitHub
- URL: https://github.com/mariarodr1136/ecohabittracker
- Owner: mariarodr1136
- Created: 2024-10-19T18:27:49.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-01-13T14:31:42.000Z (9 months ago)
- Last Synced: 2025-03-28T23:51:12.790Z (7 months ago)
- Topics: children-games, ecosystem, environmental, gamification, habit-tracking, ios, ios-app, ios-swift, swift, swiftui
- Language: Swift
- Homepage:
- Size: 21.6 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EcoHabit Tracker ♻️🦸♀️
**EcoHabit Tracker** is an engaging **iOS app** designed to inspire and empower kids to adopt **sustainable habits** in a fun, interactive, and educational way. By leveraging **gamification**, engaging challenges, and bite-sized educational tips, this app teaches kids the importance of making **eco-friendly choices** in their daily lives.
Through completing exciting **sustainability challenges**, tracking their progress, and earning rewards, kids learn how their small actions—such as reducing plastic use, conserving water, and adopting **energy-saving habits**—can collectively make a big difference for the environment.
The app also features an **AI-powered assistant**, offering **personalized guidance**, answering environmental questions, and motivating kids with encouraging messages. This combination of **education**, **technology**, and **gamification** helps foster a generation of **eco-heroes** who feel equipped and motivated to lead a greener future while having fun along the way.
   
## Table of Contents
- [Purpose](#purpose)
- [Features](#features)
- [Code Structure](#code-structure)
- [Installation](#installation)
- [Requirements](#requirements)
- [Contributing](#contributing)
- [Contact](#contact-)
## Purpose:
EcoHabit Tracker aims to make sustainable living exciting for kids by motivating them to adopt eco-friendly habits such as reducing plastic use, saving water, and eating plant-based meals. By completing challenges, earning points, and learning fun facts, kids can see the impact of their actions and inspire others to do the same.
## Features:
- **Gamification**: Earn points for completing challenges and building eco-friendly habits.
- **Challenges**: Take on sustainability challenges that promote eco-friendly behaviors.
- **Impact Tracker**: Track your progress and see the environmental impact of your actions.
- **Rewards**: Unlock medals (Bronze, Silver, Gold, and Platinum) based on earned points.
- **Educational Tips**: Receive daily tips and fun facts about sustainability.
- **AI Assistant**: Integrated a conversational AI assistant powered by the Hugging Face API to provide personalized guidance, answer queries related to environmental impact, and motivate users with inspiring messages.
---
---
## Code Structure:
The app is built using Swift and SwiftUI. It consists of several key components:
- **HomeView**: The main interface where users can view challenges, receive tips, and track progress.
- **ChallengesView**: Allows users to browse, filter, and start eco-friendly challenges, tracking their progress along the way.
- **RewardsView**: Displays the rewards system where users can see the medals they’ve earned and how many points they need for the next level.
- **AI Integration**: Leverages the Hugging Face API to integrate a conversational assistant that enhances user interaction.
---
AI Assistant Update
---
## Installation:
1. Clone the repository:
```bash
git clone https://github.com/mariarodr1136/EcoHabitTracker.git
2. Open the project in Xcode.
3. **Important Step**: Obtain an API key from Hugging Face to ensure the app works as expected. Follow these steps to get your token:
- Visit [Hugging Face](https://huggingface.co) and sign up for a free account if you don’t already have one.
- Log in, and go to Settings by clicking your profile picture in the top-right corner.
- Select Access Tokens and click New Token.
- Name your token (e.g., “EcoHabitTracker”) and click Generate Token.
- Copy the generated token.
- Open the ChatMessage class file and navigate to line 23. Update the following line by pasting your token:
```bash
private let apiToken = "your_generated_token_here"
4. Run the app on the simulator or on a physical iOS device.
## Requirements
- macOS Sonoma or later
- Xcode 16.2 or later
- iOS 14.0 or later
- Swift 5.3 or later
## Contributing:
Feel free to submit issues or pull requests for improvements or bug fixes. All contributions are welcome to enhance the app’s features or functionality!
To contribute, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bug fix:
```bash
git checkout -b feat/your-feature-name
- Alternatively, for bug fixes:
```bash
git checkout -b fix/your-bug-fix-name
3. Make your changes and run all tests before committing the changes and make sure all tests are passed.
4. After all tests are passed, commit your changes with descriptive messages:
```bash
git commit -m 'add your commit message'
5. Push your changes to your forked repository:
```bash
git push origin feat/your-feature-name.
6. Submit a pull request to the main repository, explaining your changes and providing any necessary details.
## Contact 🌐
If you have any questions or feedback, feel free to reach out at [mrodr.contact@gmail.com](mailto:mrodr.contact@gmail.com).