EcoPulse Kenya is a platform to track eco-friendly actions like planting trees, recycling, and saving water. Every small action contributes to a greener Kenya. Track your actions, stay motivated, and make an impact!
Just replace your current README.md with this content β¬οΈ
# πͺ΄ EcoPulse Kenya
**EcoPulse Kenya** is a responsive React application designed to track eco-friendly actions and encourage sustainable habits.
Users can log activities like planting trees, recycling, or conserving water β while tracking their progress, earning badges, and discovering daily eco-tips.
---
## β¨ Features
- π± **Track Green Actions:** Add, complete, and delete eco-tasks.
- π **Task Filters:** View *All*, *Completed*, or *Pending* tasks.
- π **Progress Bar:** Visualize your completion percentage.
- πΎ **Persistent Storage:** Tasks are saved in browser **localStorage**.
- π‘ **Eco Tips:** Daily sustainability tips fetched from an API.
- π **Dark/Light Mode:** Toggle seamlessly between themes.
- π **Gamification Badges:**
- 1+ tasks β *Eco Starter*
- 5+ tasks β *Eco Hero*
- 10+ tasks β *Eco Champion*
- π± **Responsive Design:** Optimized for mobile, tablet, and desktop.
- ποΈ **Smooth Animations:** Subtle task transitions and toast notifications.
---
## π¨ Screenshots
π οΈ Technologies Used
Category Tools / Libraries
Frontend React.js, JSX, Tailwind CSS
Routing React Router
State Management React Hooks (useState, useEffect, useContext)
Persistence Custom useLocalStorage Hook
Animations Framer Motion + Tailwind CSS transitions
API Local API simulation for eco tips
Build Tool Vite.js
Deployment Vercel
βοΈ Setup Instructions
1οΈβ£ Clone the Repository
git clone
github.com
cd ecopulse-kenya
2οΈβ£ Install Dependencies
npm install
3οΈβ£ Run the Development Server
npm run dev
Open
localhost
in your browser.
4οΈβ£ Build for Production
npm run build
5οΈβ£ Deploy
Vercel: Use the vercel CLI (vercel deploy) or connect the GitHub repo.
Netlify: Drag and drop the dist folder into your Netlify dashboard.
π§© Project Structure
src/
βββ components/ # Reusable UI components (Navbar, Footer, Card, Button, TaskInput)
βββ pages/ # Page components (Home, β¦