Skip to content

A modular, mobile-first platform that promotes eco-friendly actions through gamification, token rewards, NFTs, and social engagement.

License

Notifications You must be signed in to change notification settings

PolymersNetwork/carbon-credit-platform-scaffold

Repository files navigation

$PLASTIC - Eco-Friendly Action Platform

A modular, mobile-first platform that promotes eco-friendly actions through gamification, token rewards, NFTs, and social engagement.

🌱 Overview

$PLASTIC is a comprehensive platform that incentivizes environmental actions through blockchain technology, gamification, and AI-powered personalization. Users earn $PLASTIC tokens for verified eco-actions, collect NFTs, compete on leaderboards, and participate in community challenges.

🏗️ Architecture

This is a monorepo built with:

  • Backend: Encore.ts (TypeScript REST API framework)
  • Frontend: React with TypeScript, Tailwind CSS, shadcn/ui
  • Database: PostgreSQL (via Encore.ts SQL Database)
  • Blockchain: Solana integration for tokens, NFTs, and payments

🚀 Features

Core Features

  • 💰 Wallet & Payments (Solana Pay + fiat)
  • 🌍 Eco-Action Tracking with verification
  • 🎮 Gamification & Token Rewards
  • 🏆 Leaderboards & Challenges
  • 📊 Analytics Dashboard
  • 📱 Mobile-first responsive design

Tokenomics

  • Token: $PLASTIC
  • Total Supply: 18.44 billion
  • Utility: Rewards, NFT minting, staking, governance
  • Distribution: Community rewards, development, partnerships

Advanced Features

  • 🤖 AI-powered personalized recommendations
  • 🔄 Offline-first with sync capabilities
  • 🎯 Real-time notifications
  • 🛡️ Fraud detection and security
  • 📈 Predictive analytics

📁 Project Structure

``` /backend/ # Encore.ts backend services /user/ # User management service /wallet/ # Wallet and payment service /actions/ # Eco-action tracking service /rewards/ # Rewards and gamification service /leaderboard/ # Leaderboard service /nft/ # NFT management service /ai/ # AI services /analytics/ # Analytics service

/frontend/ # React frontend application /components/ # Reusable UI components /pages/ # Application pages /hooks/ # Custom React hooks /types/ # TypeScript type definitions /utils/ # Utility functions /constants/ # Application constants /context/ # React context providers

/shared/ # Shared utilities and types ```

🛠️ Development

Prerequisites

  • Node.js 18+
  • Encore CLI

Getting Started

  1. Install Encore CLI: ```bash curl -L https://encore.dev/install.sh | bash ```

  2. Run the application: ```bash encore run ```

  3. Access the application:

Environment Setup

Configure secrets in the Encore dashboard (Infrastructure tab):

  • SolanaRPCURL: Solana RPC endpoint
  • OpenAIKey: OpenAI API key for AI services
  • PaymentGatewayKey: Payment gateway API key

🎯 Key Components

Backend Services

  • User Service: Profile management and authentication
  • Wallet Service: Solana wallet integration and payments
  • Actions Service: Eco-action tracking and verification
  • Rewards Service: Token distribution and gamification
  • Leaderboard Service: Rankings and competitions
  • NFT Service: NFT minting and management
  • AI Service: Personalized recommendations and analytics

Frontend Features

  • Dashboard: Overview of tokens, NFTs, and progress
  • Actions: Track and verify eco-friendly activities
  • Leaderboard: Global and friend rankings
  • Wallet: Manage tokens and payments
  • Profile: User settings and achievements
  • Challenges: Participate in community events

🔗 Integrations

  • Solana: Blockchain for tokens and NFTs
  • AI Services: OpenAI for personalized recommendations
  • Payment Gateways: Fiat payment processing
  • Analytics: User behavior and platform metrics

📊 Tokenomics

Allocation Percentage Amount (Billions)
Community Rewards 40% 7.376
Team/Advisors 20% 3.688
Partners & NGOs 15% 2.766
Platform Development 15% 2.766
Reserve & Liquidity 10% 1.844

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🌟 Roadmap

  • Mobile app (React Native)
  • Advanced AI features
  • IoT device integration
  • Merchant partnerships
  • Governance token features
  • Cross-chain compatibility

Built with 💚 for a sustainable future

About

A modular, mobile-first platform that promotes eco-friendly actions through gamification, token rewards, NFTs, and social engagement.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages