interplanetary impact index
TypeScript 98.8%
CSS 1.2%
JavaScript 0.1%
27 1 0

Clone this repository

https://tangled.org/daviddao.org/eii-frontend
git@tangled.org:daviddao.org/eii-frontend

For self-hosted knots, clone URLs may differ based on your setup.

README.md

Interplanetary Impact Index#

Next.js React TypeScript Tailwind CSS

A comprehensive dashboard for tracking and visualizing the real-world impact of web3 ecosystem projects. Built with Next.js 15, this platform provides transparent, data-driven insights into financial sustainability, geographic reach, and measurable outcomes across web3 projects.

🌟 Features#

📊 Dashboard Overview#

  • Real-time Metrics: Total funding, distributed funds, sustainability percentages, and global beneficiaries
  • Interactive Charts: Trend analysis with historical data visualization using Recharts
  • Project Directory: Comprehensive table of web3 projects with sortable and filterable data
  • Geographic Insights: Global distribution maps showing project reach and impact

🔍 Project Details#

  • Individual Project Pages: Detailed breakdown of each project's impact metrics
  • Funding History: Complete funding timeline with grant, investment, and revenue sources
  • Geographic Distribution: Country-by-country breakdown of beneficiaries and value distributed
  • Impact Metrics: Project-specific KPIs and measurable outcomes

📈 Data Visualization#

  • World Map Integration: Interactive Leaflet maps showing global project distribution
  • Trend Charts: Historical funding and impact trend analysis
  • Responsive Design: Optimized for desktop and mobile viewing
  • Dark/Light Theme: Automatic theme switching with next-themes

📚 Educational Content#

  • About Page: Mission, values, and project goals
  • Methodology Page: Transparent data collection and measurement framework
  • Project Submission: Community-driven data contribution system

🛠 Technology Stack#

📊 Data Structure#

The platform tracks comprehensive metrics for each web3 project:

Core Metrics#

  • Financial Data: Funding received, sustainable revenue percentage, annual budget
  • Team Information: Full-time equivalent team size and efficiency ratios
  • Distribution: Value distributed externally through grants, UBI, or other mechanisms

Geographic Impact#

  • Country Distribution: Beneficiaries and value distributed by country
  • Global Reach: Worldwide project impact visualization

Impact Categories#

  • Climate Positive
  • Financial Inclusion
  • Community
  • Public Goods
  • Developer Ecosystem
  • Education
  • Healthcare
  • UBI (Universal Basic Income)

🚀 Getting Started#

Prerequisites#

  • Node.js 18+ and npm/yarn/pnpm
  • Git

Installation#

  1. Clone the repository

    git clone https://github.com/your-username/web3-impact-index.git
    cd web3-impact-index
    
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
    
  3. Start the development server

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
    
  4. Open your browser Navigate to http://localhost:3000 to see the application.

Build for Production#

npm run build
npm start

📁 Project Structure#

web3-impact-index/
├── app/                    # Next.js App Router pages
│   ├── about/             # About page
│   ├── methodology/       # Methodology documentation
│   ├── project/           # Dynamic project detail pages
│   ├── submit/            # Project submission form
│   ├── globals.css        # Global styles
│   ├── layout.tsx         # Root layout
│   └── page.tsx           # Homepage
├── components/            # React components
│   ├── FundingChart.tsx   # Funding trend charts
│   ├── MainContent.tsx    # Main dashboard layout
│   ├── ProjectTable.tsx   # Projects data table
│   ├── Sidebar.tsx        # Navigation sidebar
│   ├── WorldMap.tsx       # Geographic visualization
│   └── ...
├── lib/                   # Utility functions and data
│   ├── data.ts           # Sample project data
│   └── types.ts          # TypeScript type definitions
├── public/               # Static assets
│   ├── logo.png          # Project logo
│   └── ...
└── package.json          # Dependencies and scripts

📋 Available Scripts#

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint

🎯 Methodology#

Data Sources#

  • Project Self-Reporting: Standardized submission forms with public verification
  • Public Records: Financial disclosures, grant databases, and annual reports
  • On-Chain Data: Transaction verification for distribution tracking
  • Community Verification: Cross-referencing with public funding databases

Key Metrics#

  • Funding Received: Total lifetime funding from all sources
  • Sustainable Revenue %: Recurring revenue vs. one-time funding ratio
  • Geographic Distribution: Countries served with beneficiary counts
  • Distribution Efficiency: External funding distributed vs. received ratio

Verification Process#

  • ✅ Cross-reference with public funding databases
  • ✅ On-chain verification where applicable
  • ✅ Community review and correction process
  • ✅ Regular data updates and refresh cycles

🤝 Contributing#

We welcome contributions from the community! Here's how you can help:

Ways to Contribute#

  1. Submit Project Data: Add your web3 project's impact metrics
  2. Improve Methodology: Suggest enhancements to our metrics framework
  3. Bug Reports: Report issues and help us improve the platform
  4. Feature Requests: Propose new functionality and improvements
  5. Code Contributions: Submit pull requests for bug fixes and features

Development Guidelines#

  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

Project Submission Process#

  • Visit the /submit page to add your project
  • Provide comprehensive impact metrics and funding data
  • Include geographic distribution and beneficiary information
  • Submit verifiable sources for all data points

📄 License#

This project is open source and available under the MIT License.

🙋‍♂️ Support#

Getting Help#

Contact#

🔮 Future Roadmap#

Planned Features#

  • Real-time data updates via API integration
  • Advanced filtering and search capabilities
  • Export functionality for data analysis
  • Integration with blockchain analytics platforms
  • Mobile application companion
  • Multi-language support

Research Initiatives#

  • Longitudinal impact studies
  • Comparative analysis frameworks
  • Sustainability prediction models
  • Geographic impact correlation analysis

Built with ❤️ for the web3 ecosystem

Helping stakeholders make informed decisions about where to direct resources for the greatest collective benefit.