---

cgov - Cardano Governance Platform

powered by SIDAN Lab & MeshJS

---

cgov is an open-source Cardano governance platform for monitoring, tracking, and participating in on-chain governance actions. It integrates with the following component(s):

• api - Core API server as backend supporting the application

Features

Proposal dashboard & detail pages

• Dashboard Overview - Track total, active, ratified, enacted, expired, and closed governance proposals
• Net Change Limit (NCL) - Monitor treasury spending limits by year with progress visualization
• Live Voting Data - Real-time vote percentages with donut chart visualizations
• Vote Analysis - Detailed breakdown of active, abstain, always-abstain, inactive, and pending votes
• Bubble Map Visualization - Interactive bubble visualization of voting distribution
• Voting Trends - Line charts showing cumulative voting power over time
• Searc & download Voting Records - Filter and search all votes with export to JSON/CSV/Markdown
• Theme System - Light (Fancy), Dark (Nerd), and Game themes

DRep dashboard & detail pages

• DRep Dashboard Overview - track overall metrics of DReps, engagements, activity
• DRep Charts - Multiple chart views to visualise DRep by voting power & delegator counts
• DRep Profile pages - dedicated profile pages for all active DReps, including DRep info, evolution, metric tracker and voting history

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn
• Backend API server running (see api repository)

Installation

# Clone the repository
git clone https://github.com/nomos-guild/cgov.git
cd cgov

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env

Configuration

Create a .env file with the following variables:

BACKEND_API_URL=http://localhost:3005  # Backend API base URL
BACKEND_API_KEY="your-api-key"         # Authentication key

Note: These environment variables are server-side only and not exposed to the browser.

Development

npm run dev

Visit http://localhost:3000 to view the application.

Production Build

npm run build
npm run start

Governance Action Types

The platform supports all Cardano governance action types:

• Motion of No-Confidence
• Update Committee / Terms
• Constitution Update (New Constitution)
• Hard Fork Initiation
• Protocol Parameter Change
• Treasury Withdrawal
• Info Action

Voter Types

Type	Description	Voting Power
DRep	Delegated Representatives	ADA-based
SPO	Stake Pool Operators	ADA-based
CC	Constitutional Committee	Count-based

Documentation

Additional documentation is available in the docs/ folder:

• Project Description
• Database Schema
• Architecture Decisions
• Theming Guide

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

Apache-2.0

---