https://github.com/flurry101/ecopulse
a website to calculate and reduce your carbon footprint with personalized tips & resources, making sustainability fun and empowering eco-friendly living 🌍💚
https://github.com/flurry101/ecopulse
carbon-footprint ecopulse sustainability
Last synced: about 2 months ago
JSON representation
a website to calculate and reduce your carbon footprint with personalized tips & resources, making sustainability fun and empowering eco-friendly living 🌍💚
- Host: GitHub
- URL: https://github.com/flurry101/ecopulse
- Owner: flurry101
- License: mit
- Created: 2025-05-27T15:45:35.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-06T15:21:35.000Z (2 months ago)
- Last Synced: 2025-08-06T16:14:53.658Z (2 months ago)
- Topics: carbon-footprint, ecopulse, sustainability
- Language: TypeScript
- Homepage: https://ecopulse-querencia.vercel.app
- Size: 336 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EcoPulse
**EcoPulse** is a responsive web application that helps individuals understand and reduce their carbon footprint. By combining a personal carbon calculator with educational content, quizzes, and gamified progress tracking, the app empowers users to make informed lifestyle changes. With personlized insights, sustainability tips, and education-driven features, EcoPulse turns awareness into action— reducing one carbon footprint at a time.
---
## 🚀 Getting Started
### Prerequisites
- Node.js 18+
- npm or pnpm package manager
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/yourusername/ecopulse.git
cd ecopulse
```
2. **Install dependencies**
```bash
npm install
# or
pnpm install
```
3. **Run the development server**
```bash
npm run dev
# or
pnpm dev
```
4. **Open your browser**
Navigate to [http://localhost:3000](http://localhost:3000)
---
## 📁 Project Structure
```
ecopulse/
├── app/ # Next.js App Router
│ ├── components/ # React components (TSX/JSX)
│ │ ├── shared/
│ │ ├── favicon.ico # Favicon
│ │ ├── carbon-calculator.jsx # Carbon Calculator
│ │ ├── education.tsx # Learning resources and content
│ │ ├── environmental-quiz.tsx # Interactive quiz
│ │ └── community-features.tsx # Community components
│ ├── utils/ # Standard Carbon Emissions Data
│ ├── hooks/ # Custom React hooks
│ ├── globals.css # Global styles
│ ├── layout.jsx # Root layout
│ ├── loading.jsx # Loading component
│ └── page.jsx # Main application
├── components/ # Shared components
│ ├── ui/ # Reusable UI components
│ ├── theme-provider.tsx # Next.js Theme provider
│ └── video-modal.tsx
├── hooks/ # Custom React hooks
├── lib/ # Shared utilities
├── utils/ # Helper functions (amth, formatting, calculations)
├── public/ # Static assets
├── types/ # TypeScript type definitions
├── styles/ # Additional styles
├── vercel.json # Vercel deployment configuration
├── next.config.mjs # Next.js configuration
├── tailwind.config.ts # Tailwind configuration
├── tsconfig.json # TypeScript configuration
└── package.json # Dependencies and scripts
```
---
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## Contributors
- [Sravya](https://github.com/flurry101)
---
## References
- Carbon emission factors from EPA and IPCC guidelines
- UI components from Shadcn/UI
- Icons from Lucide React
- Inspiration from leading sustainability apps
---
**Built with 💚 for a sustainable future**