- JavaScript 78.6%
- EJS 11.2%
- CSS 4.9%
- Shell 4.8%
- Rust 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- 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> |
||
| .github/workflows | ||
| docs | ||
| examples | ||
| proxmox | ||
| public | ||
| scripts | ||
| src | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| plan.md | ||
| planned.md | ||
| README.md | ||
| SECURITY.md | ||
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.
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
- Overview & concepts — the network model, terminology
- Getting started — install, first run, day-one usage
- Configuration — environment variables, Docker, reverse proxy, push keys
Using Extrovert
- Posts & the feed algorithm
- Profiles & customization
- Discovery & search
- Notifications
- Direct messages (E2EE)
- Rooms & voice channels
- Calls & presence
- Stickers
- Settings & account
- Admin guide
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).