Skip to main content

Welcome to Chirp Documentation

Chirp is a modern, self-hostable social platform built with privacy in mind. It provides Discord-like functionality with servers, channels, direct messages, media sharing, and real-time communication, all while giving you complete control over your data.

🎵 Chirp

Why Choose Chirp?​

🏠 Self-Hosted & Private​

  • Complete Data Control: Your data stays on your server, under your control
  • No Tracking: No analytics, no telemetry, no data mining
  • Privacy First: Built with privacy as the core principle, not an afterthought

🛠️ Modern Technology Stack​

  • Frontend: React 19 with Vite, Tailwind CSS, and Zustand
  • Backend: Node.js with Express and Socket.IO
  • Database: PostgreSQL with comprehensive migration support
  • Desktop: Electron app with auto-updater
  • Mobile: Capacitor-based mobile apps

🔧 Administrator Friendly​

  • Role-Based Permissions: Comprehensive permission system
  • API Access: Full REST API for automation and integrations
  • Docker Support: Easy containerized deployment

Key Features​

Communication​

  • Text Channels: Real-time messaging with rich text support
  • Media Channels: Dedicated spaces for browsing and sharing media
  • Forum Channels: Threaded discussions with tags and following
  • Direct Messages: Private conversations with file sharing
  • Group Chats: Multi-user private conversations

Rich Content​

  • File Attachments: Upload and share any file type
  • Image Previews: Automatic thumbnails and previews
  • GIF Integration: Built-in GIF search via Tenor API
  • Link Previews: Rich previews for shared links
  • Reactions: Add emoji reactions to messages
  • Polls: Create and participate in polls

Collaboration​

  • Collaborative Channels: Real-time document editing & note taking
  • Wikis: Knowledge base creation and management

User Experience​

  • Themes: Light, dark, and custom themes
  • Notifications: Customizable notification system
  • Search: Full-text search across messages and content
  • Mobile Support: Native Android experience & optimized mobile web page

Who is Chirp For?​

🏢 Businesses & Organizations​

  • Internal team communication
  • Project collaboration spaces
  • Client communication portals
  • Knowledge management systems

👥 Communities​

  • Gaming communities
  • Interest groups
  • Educational platforms
  • Social networks

👨‍💻 Developers & Tech Enthusiasts​

  • Self-hosting advocates
  • Privacy-conscious users
  • Custom platform development
  • API integration projects

Ready to get started? Let's begin your Chirp journey!