Skip to main content

Overview

The Agora Forum system is a comprehensive discussion platform built for DAO governance and community engagement. It provides a multi-tenant architecture supporting categories, topics, posts, attachments, reactions, upvoting, and advanced moderation features.

Multi-tenant Architecture

Isolated data per DAO using dao_slug for complete data separation

Real-time Interactions

Emoji reactions, upvoting, and live updates for engaging discussions

Content Moderation

NSFW detection, soft/hard deletion, and archival capabilities

File Management

IPFS-based document storage and sharing with content addressing

Key Features

Discussion Features

  • Categories & Topics: Organize discussions into categories with topic threads
  • Nested Replies: Support for threaded conversations with parent-child post relationships
  • Rich Content: Markdown support with inline attachments and images
  • Reactions: Express engagement with emoji reactions on any post
  • Upvoting: Community-driven content curation through topic upvotes

Moderation & Security

  • Automatic NSFW Detection: Content filtering using OpenAI moderation service
  • Soft & Hard Deletion: Flexible content removal with recovery options
  • Archive System: Move content to archived state without deletion
  • Role-based Permissions: Granular access control with admin hierarchy
  • Audit Logging: Complete trail of all administrative actions

Integration Features

  • Search Integration: Full-text search with real-time indexing
  • DUNA Support: Specialized components for quarterly reports and documents
  • Subscription System: Follow topics and categories for notifications
  • Analytics: View tracking and engagement metrics
  • IPFS Storage: Decentralized file storage with Pinata integration

System Requirements

PostgreSQL with Prisma ORM for reliable data management
IPFS via Pinata for decentralized file storage
Web3 wallet integration with signature verification

Quick Start

1

Connect Wallet

Users must connect their Web3 wallet to participate in discussions
2

Browse Categories

Explore forum categories to find relevant discussions
3

Create Topics

Start new discussions by creating topics (with sufficient voting power)
4

Engage

Reply to posts, add reactions, and upvote quality content

Architecture Overview

The forum system follows a layered architecture:

Next Steps

Architecture

Learn about the database schema and system design

Topics & Posts

Understand how to create and manage forum content

Reactions

Add emoji reactions and upvoting to your forum

Moderation

Set up content moderation and admin tools

Build docs developers (and LLMs) love