1984 is coming, and we must be prepared. Full Social Media meant to cover all your needs - with a more modern encryption then Matrix!
  • JavaScript 78.6%
  • EJS 11.2%
  • CSS 4.9%
  • Shell 4.8%
  • Rust 0.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
lea edfb6a6cf9
Some checks are pending
CI / Test suites (push) Waiting to run
CI / Shell scripts (push) Waiting to run
CI / Docker image build (push) Waiting to run
feat(profiles): give profiles a fixed theme
- store a profile theme (dark/light/october) and a pin flag per profile
- render pinned profiles with the stored theme, independent of the
  visitor's or owner's live site theme
- backfill existing profile customizations to the owner's theme at
  startup so they stop shifting when themes change
- add owner-only editor controls: keep colors on every theme plus a
  profile theme selector, with a live preview while pinned
- turning the pin off follows the visitor's site theme
- update docs, changelog and profile editor coverage

Co-authored-by: CommandCodeBot <noreply@commandcode.ai>
2026-11-18 11:23:41 +01:00
.github/workflows feat(profile): Easy Editing visual profile editor 2026-10-08 16:55:20 +02:00
docs feat(profiles): give profiles a fixed theme 2026-11-18 11:23:41 +01:00
examples docs: bring the docs, README and API spec up to date 2026-10-07 18:29:28 +02:00
proxmox fix(proxmox): sync updater origin with the configured repo 2026-11-14 23:01:00 +01:00
public feat(profiles): give profiles a fixed theme 2026-11-18 11:23:41 +01:00
scripts feat(profiles): give profiles a fixed theme 2026-11-18 11:23:41 +01:00
src feat(profiles): give profiles a fixed theme 2026-11-18 11:23:41 +01:00
.dockerignore feat(chat): add message deletion for DMs and room channels 2026-08-13 10:19:19 +02:00
.env.example feat(drive): per-user Nextcloud storage backend 2026-11-15 16:07:52 +01:00
.gitignore test(mls): add cross-implementation interop harness with mls-rs (TASK-1A-2) 2026-10-04 19:07:53 +02:00
AGENTS.md feat(e2ee): server-side client ergonomics, batch bundles, session sync, and realtime key push 2026-10-03 01:09:34 +02:00
CHANGELOG.md feat(profiles): give profiles a fixed theme 2026-11-18 11:23:41 +01:00
docker-compose.yml fix(auth): accept proxied HTTPS in production 2026-10-07 10:33:20 +02:00
Dockerfile feat(fonts): sanitize uploaded fonts server-side; add Terms of Service 2026-10-07 22:38:47 +02:00
LICENSE License Extrovert under GPLv3 (GPL-3.0-or-later): full license text, package.json license field, README license section; wiki serves /docs/LICENSE for non-markdown repo files 2026-08-01 20:17:38 +02:00
package-lock.json feat(drive): per-user Nextcloud storage backend 2026-11-15 16:07:52 +01:00
package.json fix(rooms): decrypt history without waiting for MLS membership 2026-11-16 13:16:34 +01:00
plan.md feat(bots): Discord/Telegram-style bot accounts (planned.md F5) 2026-10-06 19:33:16 +02:00
planned.md feat(auth): TOTP two-factor authentication + WebAuthn passkeys (planned.md F2/F3) 2026-08-23 01:28:24 +02:00
README.md docs: bring the docs, README and API spec up to date 2026-10-07 18:29:28 +02:00
SECURITY.md docs: bring the docs, README and API spec up to date 2026-10-07 18:29:28 +02:00

Extrovert

Note

Canonical repository: Extrovert is actively maintained at git.new-eve.org/redforged/extrovert. The GitHub repository is an automated mirror.

A social network where you can only discover content from friends and friends-of-friends. You cannot see anything from people you aren't connected to — there is no public timeline, no firehose, no algorithm mining the whole internet. Just your network.

License: GPL-3.0-or-later Build status all suites pass Docker image size PRs welcome

The signature motif is three concentric rings: you (inner), your friends (middle), and your friends-of-friends (outer).

┌────────────────────────────────────────────┐
│  o o o o o o o o o o o o o o o o o o o o   │   friends-of-friends (visible content)
│  o   ┌────────────────────────────┐     o  │
│  o   │ o o o o o o o o o o o o o  │     o  │   friends (visible content)
│  o   │ o o o ┌────────────┐  o o  │     o  │
│  o   │ o o o │    you     │  o o  │     o  │   you (your own content)
│  o   │ o o o └────────────┘  o o  │     o  │
│  o   │ o o o o o o o o o o o o o  │     o  │
│  o   └────────────────────────────┘     o  │
│  o o o o o o o o o o o o o o o o o o o o   │
└────────────────────────────────────────────┘
  everyone else: invisible

Feature overview

Area What you get
Posts Text, photo, or video posts; Markdown support; reposts; comment threads; edit history; full deletion
Feed A deterministic, explained ranking algorithm over your network only (see Feed)
Profiles Fully customizable profile pages — every user can write their own HTML and CSS (no JavaScript)
Social Follow, like, comment, share, repost, "follow because of a post"
Discovery Discover page: search users, friend-of-friend suggestions, network-bound post search
Messaging End-to-end-encrypted direct messages between mutual followers (MLS, RFC 9420); optional Additional Security mode deletes messages from the server once both users have received them (device-only copies)
Rooms Group spaces with channels (text + voice), role-based permissions, E2EE group chat (MLS), voice calls
Calls Peer-to-peer WebRTC calls with presence, offline-call rings, and push wake-ups
Notifications Inbox, unread badges, realtime SSE stream, web push
Stickers Personal sticker packs usable in posts, comments, and messages
Admin Bans, user deletion, promotions, room moderation, reports queue, server-wide announcement
API Full REST API (OAuth 2.0 + OpenID Connect, Dynamic Client Registration, Personal Access Tokens) with OpenAPI 3.1 spec, Swagger UI, and Realtime WebSocket Gateway
Security Responsible disclosure: public /security page with a private report form for admins, plus RFC 9116 /.well-known/security.txt

Security posture is documented in docs/security.md; the audit history lives in SECURITY.md. Security researchers can test the software under the conditions on the in-app /security page and report findings privately.

Quick start

npm install
npm start          # http://localhost:3000

You must set a SESSION_SECRET environment variable before the server will start. See Getting started and Configuration.

Development & testing

Every push and pull request runs all of the following on GitHub Actions — see .github/workflows/ci.yml. The Docker image build is part of CI too.

  • npm test — feed algorithm + sanitization unit tests (24 assertions)
  • npm run test:api — REST API integration suite (36 tests)
  • npm run test:client — Native client REST API & Realtime Gateway parity suite (25 tests)
  • npm run test:bootstrap — Client bootstrap, device pairing & optimistic sync suite (10 tests)
  • npm run test:owasp — OWASP Top 10 (2021) security suite (47 tests)
  • npm run test:asvs — OWASP ASVS v4.0 suite (57 tests; automatable subset, with a MANUAL_REVIEW/N-A scorecard)
  • npm run seed:client — Seed deterministic fixtures and PATs for client testing (alice, bob, charlie)
  • plus the MLS suites (npm run test:mls, test:ietf, test:interop, test:scale), OAuth, 2FA, passkeys, captcha, email and render suites — see Development & testing

Documentation index

Basics

Using Extrovert

For developers

Reference

License

Extrovert is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3 or any later version — see LICENSE for the full text. It is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GPLv3 for details.

The app includes bundled third-party software under their own licenses (e.g. ts-mls, the RFC 9420 implementation bundled into public/lib/mls.js).