Skip to content

Repository files navigation

🌱 EcoCity PPY Token Dashboard: Transforming Urban Waste into Digital Value

Deploy with Vercel License: MIT TypeScript React

🎯 Project Overview

EcoCity PPY Token Dashboard is a cutting-edge blockchain application that revolutionizes urban sustainability by transforming waste into digital value. Our platform provides real-time insights into the waste-to-value economic model on the Optimism Mainnet.

🌐 Live Demo: ecocities.ethcali.org

🌍 Economic Model

1 PPY = 1 KG = 1K COP = 1K COPe

Where:

  • PPY: Project Token
  • KG: Waste Recovered
  • COP: Colombian Peso
  • COPe: Colombian Environmental Peso

✨ Key Features

📊 Essential Metrics

  • Community Holders: Track democratic participation
  • Daily Volume: Monitor economic activity in COP
  • Waste Value Recovered: Measure environmental impact (kg/day)
  • Active Communities: Show decentralized governance adoption
  • Solar Energy Generated: Renewable energy production (kWh)
  • Governance Proposals: Democratic decision-making activity

📈 Interactive Visualizations

  • Environmental impact trends
  • Solar energy generation metrics
  • Community participation growth
  • Real-time price stability visualization

🌱 Sustainability Highlights

  • ♻️ Waste-to-Value: Each token backed 1:1 by recycled materials value
  • 🏛️ Community Governance: Democratic environmental initiatives
  • ☀️ Renewable Energy: Powered by solar panels and battery systems
  • 🌱 Smart Cities: Energy-autonomous waste collection points
  • 📱 International Compliance: Following latest environmental regulations

🚀 Technology Stack

Core Technologies

  • Frontend: Next.js 15 + TypeScript
  • Styling: Tailwind CSS
  • Blockchain: Ethers.js (Optimism Network)
  • Charts: Chart.js
  • Deployment: Vercel

Performance Optimizations

  • Bundle splitting
  • Tree shaking
  • Static generation
  • Optimized API caching
  • Responsive design

🏗️ Project Structure

ecocity-ppy-dashboard/
├── src/
│   ├── core/                 # Core business logic
│   ├── features/             # Feature-specific components
│   ├── shared/               # Shared utilities & components
│   ├── types/                # TypeScript definitions
│   └── app/                  # Next.js app directory
├── public/                   # Static assets
└── deploy.sh                 # Deployment script

🛠️ Local Development

Prerequisites

  • Node.js 18+
  • npm 8+

Quick Start

# Clone the repository
git clone https://github.com/ethcali/ecocity-ppy-dashboard.git
cd ecocity-ppy-dashboard

# Install dependencies
npm install

# Start development server
npm run dev

Available Scripts

  • npm run dev: Start development server
  • npm run build: Build for production
  • npm run type-check: TypeScript validation
  • npm run lint: Run ESLint
  • npm run deploy:vercel: Deploy to Vercel

🔧 Configuration

Environment Setup

# Copy and configure environment
cp .env.example .env.local

# Key configurations
NEXT_PUBLIC_DOMAIN=ecocities.ethcali.org
NEXT_PUBLIC_CONTRACT_ADDRESS=0xfeEF2ce2B94B8312EEB05665e2F03efbe3B0a916

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

Development Guidelines

  • Use TypeScript
  • Follow existing code style
  • Add tests for new features
  • Update documentation
  • Ensure responsive design

📊 Performance Metrics

  • Lighthouse Score: 95+
  • Bundle Size: < 200KB gzipped
  • First Load: < 2s on 3G
  • Build Time: < 30s

📄 License

MIT License - see LICENSE file for details

🌟 Acknowledgments

  • EKINOXIS: Project development
  • heratech.com: Renewable energy technology
  • Optimism Network: Blockchain infrastructure
  • Open Source Community: Tools and libraries

📞 Support


Built with 💚 for a sustainable future Transforming cities through community-driven waste recovery and renewable energy

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages