PRODUCT 01 / DOCUMENTATION PLATFORM

Cloud Codex

Cloud Codex is where a team writes and edits documentation together, in real time, without anyone's changes overwriting anyone else's.

Source-available · read it before you buy

Specification

Merge
Yjs CRDT
Editor
Tiptap · ProseMirror
Transport
WebSocket · y-protocols
Store
MySQL 8
Auth
TOTP · OAuth · invite
Hosting
yours, entirely
Licence
Source-available
01

Under the hood

What happens between a keystroke and a saved document.

Two write paths, not one. Keystrokes travel continuously and persist as binary CRDT state; the readable HTML is written only when someone saves or publishes. Every box is a component we wrote and every number is a constant in the source.

continuousbroadcast
LANE A — EVERY MUTATION, CONTINUOUSKyleTIPTAP · LOCAL Y.DOCDylanTIPTAP · LOCAL Y.DOCWSSSESSION TOKEN60 MSG / 1 sY.Doc(logId)y-protocols/syncCONFLICT-FREE MERGEIN MEMORYdebounce 3000 msCOALESCES A BURST OFKEYSTROKES INTO ONE WRITEUPDATE logsydoc_stateBINARY CRDT STATEHTML IS NOT WRITTEN ON THIS PATHBROADCAST TO EVERY OTHER CONNECTION, AUTHOR SKIPPEDLANE B — EXPLICIT SAVE OR PUBLISHsaveCLIENT SENDS HTMLsanitizeHtmlSTRIPS INJECTIONextract imagesTO DISK, NOT BASE64process mentionsNOTIFIES THE PERSONlog activityWHO CHANGED WHATUPDATE logsHTML + YDOC_STATEON PUBLISH → VERSION++ AND A ROW IN versionsIDLE 30 s → DOC EVICTED FROM MEMORY10 CONNECTIONS PER USER · 5 MB FRAME · 2 MB HTMLLAST WRITE NEVER WINS — BOTH SURVIVE

Merge strategy

CRDT, not last-write

Two people typing in the same paragraph both keep their text. Nobody's edit is discarded to resolve a conflict.

Continuous write

3000 ms debounce

Keystrokes coalesce into one binary write, so a fast typist does not hammer the database.

Readable copy

on save or publish

The HTML behind search and export updates when someone saves, which is a deliberate split, not a race.

Where it runs

your hardware

Docker Compose, MySQL 8, one Node process. No account with us, no data leaving your network.

EditingCRDT-based conflict-free merge, so concurrent edits from multiple people combine without overwriting each other.
PresenceA WebSocket connection carries live cursors and who is viewing or editing a document as it happens.
SearchMySQL full-text search across document titles and content, scoped to what each user is allowed to read.
Access controlThree tiers of permission: per-user, per-squad, and workspace-wide.
02

What it deliberately does not do

The limits, before you find them yourself.

No public signup

Invite only

An admin issues invite tokens. There is no open registration form, which is the correct default for a company's internal documentation and the wrong one for a public wiki.

No background sync

GitHub is a live proxy

Browse repos, edit files, open pull requests, link a document to a file. There are no webhooks and nothing mirrors in the background, so nothing silently drifts.

No hosted tier

You run it

Docker Compose on your hardware. We will help you stand it up and we will build on top of it, but there is no server of ours holding your documents.

STATUS

Source-available, and yours to run.

Cloud Codex is source-available and self-hosted: the code is public, and its license lets you view, modify, and run it for personal, educational, or internal business use at no cost. Clone the repository, follow its setup instructions, and run it on your own infrastructure. There is no signup and no hosted tier to buy: if you want us to run it for you or adapt it to your environment, that is a conversation to have with us directly, not a product you can check out today.