Skip to content

seetadev/pldg-dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

80 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PLDG Dashboard (Protocol Labs Dev Guild Dashboard)

A real-time analytics dashboard for tracking developer engagement, technical progress, and contribution metrics across the Protocol Labs Developer Guild (PLDG) program β€” now enhanced with Py-libp2p, Storacha MCP, ElizaOS Plugin, and Builder Insights integration.

🌐 PLDG Website: https://www.pldg.xyz/#about

🌐 PLDG Dashboard Website: https://pldg-dashboard-theta.vercel.app/


🌍 Overview

The PLDG Dashboard provides transparent, data-driven insights into the health and growth of the Filecoin, Libp2p, and broader Protocol Labs Network (PLN) ecosystems.
It aggregates data from GitHub, Airtable, on-chain sources, and decentralized storage β€” offering real-time visualization of developer activity, engagement, and contribution trends.

Developed by C4GT (Code for GovTech) contributors, this voluntary open-source initiative fosters collaborative learning, transparency, and coordination across the Filecoin and Protocol Labs communities.


✨ Features

  • πŸ“Š Real-time engagement metrics visualization
  • 🀝 Collaboration tracking via Py-libp2p (universal connectivity dapp)
  • πŸ“ˆ Technical progress monitoring and milestone analytics
  • πŸ† Top performer and team analytics
  • πŸ€– AI-powered insights with ElizaOS Plugin (LLM summarization + agent queries)
  • πŸ“‘ Executive summary reports in Markdown & agent-readable formats
  • πŸ”„ GitHub integration for issue, PR, and commit analytics
  • 🧠 Builder Insights Engine combining on-chain + off-chain developer data
  • πŸ—ƒοΈ Storacha MCP integration for decentralized storage & persistence
  • πŸ”Œ ElizaOS plugin compatibility for agent-level dashboard querying

🧰 Tech Stack

  • Framework: Next.js 14 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS + shadcn/ui
  • Charts: Recharts
  • Data Processing: Lodash
  • Validation: Zod
  • AI / Agents:
    • ElizaOS Plugin API (Agent Integration Layer)
    • Custom LLM Summarization via OpenAI / Ollama
  • API Integration:
    • Airtable API β€” Engagement Data
    • GitHub GraphQL + Octokit REST β€” Repository Insights
    • Storacha MCP β€” Decentralized Storage
    • Py-libp2p β€” Peer-based telemetry & messaging layer

βš™οΈ Getting Started

Clone the repository:

git clone https://github.com/protocollabs/pldg-dashboard
cd pldg-dashboard

Install dependencies:

npm install

Set up environment variables:

cp .env.example .env.local

Run the development server:

npm run dev

Then open http://localhost:3000 to view the dashboard.


πŸ“‚ Project Structure

src/
β”œβ”€β”€ app/                  # Next.js App Router
β”œβ”€β”€ components/           # UI and dashboard components
β”‚   β”œβ”€β”€ dashboard/        # Dashboard-specific components
β”‚   └── ui/               # Reusable UI elements
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ utils.ts          # Utilities
β”‚   β”œβ”€β”€ validation.ts     # Zod schemas
β”‚   β”œβ”€β”€ ai.ts             # AI summarization logic
β”‚   β”œβ”€β”€ builder.ts        # Builder Insights logic
β”‚   β”œβ”€β”€ storacha.ts       # Storacha MCP integration
β”‚   └── eliza.ts          # ElizaOS Plugin interface
β”œβ”€β”€ types/                # TypeScript type definitions
└── public/
    └── data/             # Static assets or CSV mock data

πŸ”„ Data Flow

1. Data Sources

  • Airtable: Weekly engagement survey results
  • GitHub: Issues, PRs, and commits
  • Storacha MCP: Immutable snapshot storage for reports and metrics
  • ElizaOS Plugin: Agent query and insight layer
  • Internal APIs: Builder profiles + on-chain metadata

2. Processing Pipeline

  • Schema validation using Zod
  • Weighted metrics and engagement scoring
  • LLM-based summarization for weekly updates
  • Builder profile generation from activity patterns

3. Real-Time Updates

  • Refresh intervals for metrics
  • Retry logic for rate-limited APIs
  • ElizaOS agent hooks for dashboard queries

🀝 Contributing

  1. Fork this repository
  2. Create a new feature branch
  3. Submit a pull request

Interested in integrating your tool or MCP-backed service (e.g., ElizaOS, Storacha, or Py-libp2p)? Join the #pldg-devs channel on Slack or open an issue in GitHub.


πŸͺͺ License

MIT License


⚠️ Known Limitations

  1. Historical Data

    • Relies on Storacha MCP for persistence; versioning is manual
    • GitHub API resets metrics on refresh without Storacha backup
  2. AI Insights

    • Summarization quality depends on data density
    • ElizaOS agents require tuned prompts for optimal responses
  3. Real-Time Constraints

    • Airtable and GitHub APIs are rate-limited
    • Anonymous commits yield limited insight fidelity

πŸ—ΊοΈ Roadmap

βœ… Phase 1 (MVP Complete)

  • Real-time dashboard
  • GitHub + Airtable integration
  • Core analytics & AI summarization
  • Storacha test integration

🚧 Phase 2 (In Progress)

  • Builder Insights Engine (on-chain + GitHub-linked)
  • Persistent Storacha MCP snapshots
  • ElizaOS Plugin for agent-based querying
  • Weekly digest report generation

πŸš€ Phase 3 (Planned)

  • Per-team custom insights
  • Token-gated dashboards (bounty and contributor access)
  • AI-human feedback loops
  • Integration with decentralized compute (Bacalhau, Lilypad)

🌐 Ecosystem Context

The PLDG Dashboard is a Developer Tooling / Ecosystem Infrastructure project under Filecoin RetroPGF for Builders: Supporting Open Source Coordination Through PLDG.

It contributes to improving transparency, impact measurement, and talent recognition across the Protocol Labs Network β€” spanning Filecoin, IPFS, Libp2p, Fil-Oz, Fil-B, and Storacha communities.


πŸ“Ž Reference Links & Resources


🌟 Impact Summary

Since November 2024, the PLDG Dashboard has:

  • Enhanced visibility and engagement across the Filecoin developer ecosystem
  • Combined on-chain, GitHub, and AI-summarized metrics for ecosystem health
  • Empowered contributors with transparent self-reflection and progress tracking
  • Provided actionable insights for ecosystem stewards and program leads

Over time, it aims to serve as the open-source intelligence layer for developer coordination and recognition across the Protocol Labs Network.


β€œBuilding the open-source intelligence layer for the Protocol Labs Network β€” by builders, for builders.” πŸ’‘

About

Protocol Labs Developer Guild Interactive Dashboard

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 9