Skip to main content
The Revise SDK is a browser-only React component that puts a full word processor inside an application that already owns its shell, authentication, storage, and users. Your application hands the SDK a document — .docx, Markdown, plain text, or HTML — and gets a .docx back. In between, the component:
  • parses the file with Revise’s own converters, preserving comments and tracked changes on the DOCX path;
  • creates a local Yjs-backed editing session;
  • renders the document on canvas, paginated, with the native ribbon (or none at all, if you would rather build your own);
  • preserves comments and tracked changes through the round trip;
  • exposes the same JSON-schema tools Revise’s own agent uses, so whatever model you already run can read and edit the document;
  • exports back to .docx.

What it is not

The SDK deliberately does not provide accounts, authentication, document storage, collaboration servers, tenancy, billing, or an application shell. It is a component, not a platform. Nothing leaves the browser unless you wire up an agent yourself.
The SDK is proprietary software available under a commercial licence. Email sdk@revise.io for access to the package.

Two audiences, two API surfaces

The SDK is designed for two consumers at once, and keeping them straight is the single most useful idea in these docs.

Your application

Component props, callbacks, and the typed controllers on ReviseEditorHandle. Subscriptions, focus management, File and Blob objects, custom toolbars and panels. See the handle reference.

Your agent

JSON-schema tools with serializable inputs and outputs, operating on semantic document state rather than UI geometry. Safe to invoke without React state or browser focus. See agent tools.
Capabilities deliberately overlap — selection, for instance, exists on both surfaces — but the shapes differ, because a React panel and a language model want different things. Interactive concerns such as review navigation and comment-panel state are host-only by design; agents get semantic mutation tools instead.

Where it fits

AI copilots

Products that need to edit contracts, not just render them.

Vertical workflow apps

Anything replacing a round trip through Microsoft Word.

Review products

Where every change has to be attributable and reversible.

Document-heavy SaaS

Anything that currently ends in “download the .docx”.
Start with the quickstart, then read architecture to understand what the component owns and what you own.