Skip to content

cgraph-dev/CGraph

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,265 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CGraph

CGraph Logo

Secure messaging, forums, and communities — in one app

Chat • Forums • E2EE • Achievements • Subscriptions

Version Status License

Current version: 1.0.0 (March 2026)

🌐 Website · 📚 Documentation · 🔌 API Reference


⚠️ Proprietary Software

CGraph is proprietary software. Self-hosting is not permitted. All users must access CGraph through the officially hosted platform at cgraph.org.

See LICENSE for complete terms.


Why CGraph?

Feature CGraph Competitors
End-to-End Encryption ✅ PQXDH + Triple Ratchet (PQ) ⚠️ Varies
OAuth Authentication ✅ Google, Apple, Facebook ✅ Common
Community Forums ✅ Built-in
Gamification ✅ Achievements & Cosmetics
Subscription Tiers ✅ Free, Premium, Enterprise ⚠️ Basic
Role Permissions ✅ Granular ⚠️ Basic
Referral System ✅ Tiered rewards & leaderboards
Offline Support ✅ Full queue & auto-sync ⚠️ Limited

CGraph is a communication platform that puts chat, forums, and encryption together instead of making you duct-tape three different apps. It also has achievements and cosmetic customization to keep community engagement fun.


Features

💬 Real-Time Messaging

  • Messages show up instantly — typing indicators, read receipts, the works
  • E2EE via PQXDH + Triple Ratchet (post-quantum, based on Signal Protocol Rev 4)
  • Voice messages with waveform visualization
  • 1:1 and group calls over WebRTC (voice, video, screen share)
  • Reactions, edits, deletes, forwarding, GIF search
  • Syncs across web, iOS, and Android

🏢 Servers & Channels

  • Organized servers with unlimited channels
  • Channel categories for organization
  • Custom roles with 20+ granular permissions
  • Invite links with expiration and usage limits
  • Audit logs for moderation
  • Custom emoji support

📰 Community Forums

  • Posts with upvote/downvote and karma
  • Nested comments (no depth limit)
  • Thread prefixes, categories, polls
  • Leaderboards per forum
  • Moderator tools (pin, lock, move, split, merge)
  • Rich text editor + BBCode parser with syntax highlighting
  • RSS/Atom feeds

🎮 Achievements & Customization

  • 50+ Achievements across 6 categories (Social, Content, Exploration, Mastery, Legendary, Secret)
  • Titles & Badges — cosmetic unlocks you can equip
  • Profile Themes — customize your profile appearance
  • Avatar Borders — unlock decorative avatar frames
  • Chat Effects — animated message effects
  • Marketplace — browse and equip cosmetic items

🔐 Security

  • E2EE — AES-256-GCM + PQXDH key exchange (ML-KEM-768 + P-256)
  • Triple Ratchet — post-quantum forward secrecy, per-message key derivation
  • 2FA — TOTP with backup codes
  • OAuth — Google, Apple, Facebook, TikTok
  • HTTP-only cookies — no JS access to tokens
  • Trusted proxy validation — stops IP spoofing behind Cloudflare
  • Magic byte file validation — server checks actual file type, not just headers
  • Zero-knowledge — server stores encrypted blobs, can't read messages
  • GDPR — full data export and account deletion

💳 Subscription Tiers

Tier Features
Free 1 forum/group, basic features, 100MB storage
Premium 5 forums/groups, custom themes, HD video, 5GB storage
Enterprise Unlimited forums/groups, SSO/SAML, SLA, API access

📱 Mobile

  • iOS and Android via React Native + Expo SDK 54
  • Biometric auth (Face ID, fingerprint)
  • Push notifications, camera integration
  • Full offline support — queues messages/reactions while offline, syncs when you're back
  • Exponential backoff on retries so it's not hammering the server

🎁 Referrals

  • Referral codes with tiered rewards
  • Leaderboards (daily, weekly, monthly, all-time)
  • Track who signed up, claim rewards at each tier
  • Native share sheets on iOS and Android

Getting Started

Visit cgraph.org to create your account and start using CGraph.

Web App

Access CGraph directly in your browser at app.cgraph.org.

Mobile Apps

Mobile apps for iOS and Android built with React Native + Expo SDK 54. Feature parity with web across 17 capabilities including biometric auth, offline sync, push notifications, and E2EE. App Store and Google Play releases are planned.

API Access

For developers, CGraph provides a REST API. See our API Documentation.

# Example: Get current user (production URL: cgraph-backend.fly.dev)
curl -H "Authorization: Bearer YOUR_TOKEN" https://cgraph-backend.fly.dev/api/v1/me

Pricing

Plan Price Features
Free $0/forever Unlimited messaging, 1 forum/group, basic features, 100MB
Premium $9.99/mo 5 forums/groups, custom themes, HD video, 5GB storage
Enterprise Custom Unlimited everything, SSO/SAML, SLA, dedicated support, API

Visit cgraph.org/pricing for full details.


Tech Stack

Layer Technology
Backend Elixir 1.18+ / Phoenix 1.8 / PostgreSQL 16
Web React 19 / Vite / TailwindCSS / Zustand
Mobile React Native 0.81 / Expo SDK 54
Real-time Phoenix Channels (WebSocket)
Encryption PQXDH + Triple Ratchet / AES-256-GCM / ML-KEM-768
Payments Stripe (subscriptions, webhooks)
Hosting Fly.io (backend) / Cloudflare Pages (web) / Vercel (landing) / Cloudflare (CDN)

Architecture

CGraph splits the marketing site and the actual app into two separate builds:

┌──────────────────────┐              ┌──────────────────────┐
│     LANDING APP      │              │       WEB APP        │
│    cgraph.org        │              │   app.cgraph.org     │
│                      │              │                      │
│  • Marketing site    │   Login →    │  • Authenticated     │
│  • Pricing/Features  │  ─────────►  │  • Messages/Groups   │
│  • Legal pages       │              │  • Forums/Settings   │
│  • Company info      │              │  • Voice/Video       │
│                      │              │                      │
│   apps/landing/      │              │     apps/web/        │
└──────────────────────┘              └──────────────────────┘
          │                                      │
          └──────────────┬───────────────────────┘
                         │
                         ▼
              ┌──────────────────────┐
              │     BACKEND API      │
              │   api.cgraph.org     │
              │    (Fly.io)          │
              │                      │
              │  • Elixir/Phoenix    │
              │  • PostgreSQL        │
              │  • WebSocket         │
              │                      │
              │   apps/backend/      │
              └──────────────────────┘

Why split them?

  • Size: Landing page is ~200KB. The full app is ~2MB. Visitors reading the pricing page shouldn't download the crypto library.
  • SEO: Landing pages need to be crawlable. The app is a client-side SPA behind auth.
  • Caching: Landing gets CDN-cached globally. The app is dynamic.
  • Independence: They deploy separately with different CI pipelines.

Deployment

App URL Deploy Platform Purpose
Landing cgraph.org Vercel (apps/landing) Marketing, SEO
Web App app.cgraph.org Cloudflare Pages (apps/web) Authenticated app
Backend api.cgraph.org Fly.io (apps/backend) API

See CLAUDE.md for detailed architecture documentation.


Support


Legal


cgraph.org

© 2025-2026 CGraph. All Rights Reserved.

About

Secure messaging, forums, and communities — in one app. E2EE (PQXDH + Triple Ratchet), real-time chat, community forums, achievements, and subscriptions.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors