ranuts/document 发布浏览器端 Office 编辑器，支持本地编辑与实验性 AI 助手

Online Document Editor

English | 简体中文 | 日本語 | 한국어 | Deutsch | Español | Português | فارسی

Edit Word, Excel and PowerPoint files, and annotate PDFs—all in your browser. No Office installation or account required. Everyday editing stays local; turn on an experimental AI assistant to draft content, work with data and create slides.

Live site: edit.chaxus.com

✨ Features

• 🔒 Local editing — conversion, editing and export happen in the browser; you choose where optional AI requests are processed
• 📝 Editable office files — DOCX, XLSX, PPTX and CSV, plus ODF, RTF, TXT and the legacy binary formats; PDFs open and can be annotated
• 💾 Save where you want — choose a save location and keep saving to it where supported; other browsers download your exports
• 🕓 Resume your work — local recovery copies help you reopen recent edits; kept for 7 days and deletable any time (details)
• 📴 Works offline — installable as a PWA; cached editor resources can be reused offline; uncached assets and remote files still require a network
• 🌍 Multi-language — 7 languages end to end (English, 中文, 日本語, Deutsch, Español, 한국어, Português): the pages, the app UI and the editor all follow the one you pick; the editor itself ships 45
• 🧩 Embeddable — full postMessage API for iframe integration
• ✨ AI document assistant (Experimental Beta) — draft and polish text, fill spreadsheets, create slides and ask about PDFs; use an on-device model or your own AI service
• 🤖 Agent-ready — exposes WebMCP tools so a browser AI agent can open, convert and read documents
• 🚀 Deploy anywhere — a static build; a directory of files behind any web server

Say what you need. See the result in your document. Draft an update, fill a column, create a slide or ask about the current PDF page. The assistant works alongside the editor: inspect changes, cancel suggestions and use Undo after applying.

Still experimental. Answers and edits can be wrong; check important results. The assistant is off by default. Choose an on-device model or connect your own AI service. External services receive the content needed for your request.

Click a preview to watch a complete workflow at normal speed, with time to read the results. English demos use the local Qwen3 4B model and fictional information. The model is already loaded when each recording starts; response times vary by model and device.

Videos, English captions and text descriptions · User guide

PDF assistance works with selectable text on the current page and page notes. It does not recognize text in scanned images or rewrite PDF body text.

🚀 Quick start

Use it: edit.chaxus.com — nothing to install.

Self-host with Docker:

docker run -d --name document -p 8080:80 ghcr.io/ranuts/document:latest

Run from source:

git clone https://github.com/ranuts/document.git
cd document
pnpm install
pnpm run dev

📄 Formats

Any of them can be exported to PDF. CSV keeps its encoding on the way back out (UTF-8, GB18030 and Latin-1 are sniffed on open).

🔗 Routes and URL parameters

Parameters on /editor:

🔐 Local editing and data handling

Editing and conversion run locally. Where the browser allows it, saving writes straight back into the file you picked, so the document lives in your own file system and not in a downloads folder. Two things are kept in the browser itself, and both are yours to remove:

• Copies of what you edited. While you work, the editor saves the document into this browser (IndexedDB) so a refresh, a closed tab or a crash does not cost you the work. Reopening the editor offers it back. These copies exist so you can pick up where you left off — they are not a backup, so keep exporting anything you want to keep.
• Seven days, then gone. Each document is deleted automatically seven days after you last edited or opened it, whether or not you come back.

/history lists what is stored, with a delete on every row, a delete-all, and a switch to turn autosave off entirely. Deleting there takes effect immediately. On a shared machine, that is the page to visit.

The optional AI assistant is off by default. With an on-device model, document content stays on your device. When you connect an AI service, the content needed for your request is sent to that service. Browser dictation may use an online speech service. In embed mode, exported files are returned to the parent application, which controls subsequent uploads.

🧩 Embedding via iframe

Embed the editor and drive it over postMessage. The usual split is: your system handles auth and storage, the iframe handles editing.

<iframe
  id="documentEditor"
  src="https://your-deployment/editor?embed=1"
  style="width: 100%; height: 720px; border: 0"
></iframe>

// Open a document
iframe.contentWindow.postMessage(
  { id: '1', type: 'document:open-url', payload: { url: 'https://example.com/doc.xlsx' } },
  'https://your-deployment',
);

// Listen for the result
window.addEventListener('message', (e) => {
  if (e.data?.type === 'document:opened') console.log('Ready to edit');
  if (e.data?.type === 'document:saved') uploadFile(e.data.payload.file);
});

Embedded editors keep no local history — the document belongs to the host page.

→ Full API reference — every message type, the origin allowlist, read-only mode and the save flow.

Also available as a component: this project powers the document preview in @ranui/preview (docs).

🚀 Deployment

A static build — no runtime, no database.

pnpm build   # outputs to dist/

Static hosting (Cloudflare Pages, Nginx, Vercel, Netlify…)

Upload dist/. public/_headers carries the caching contract the site expects (hashed assets immutable, service worker never cached); hosts that ignore it still work, they just revalidate more.

For Nginx, serve index.html as the fallback for unknown routes:

location / {
  root /var/www/document;
  try_files $uri $uri/ /index.html;
}

GitHub Pages

.github/workflows/pages-build-site.yml builds and deploys on push to main. Enable Pages in the repository settings with GitHub Actions as the source.

Docker

# Basic
docker run -d --name document -p 8080:80 ghcr.io/ranuts/document:latest

# With HTTPS and basic auth
docker run -d --name document -p 443:443 \
  -v /path/to/certs:/ssl \
  -e SERVER_BASIC_AUTH='user:$2y$...' \
  -e SERVER_HTTP2_TLS=true \
  -e SERVER_HTTP2_TLS_CERT=/ssl/cert.pem \
  -e SERVER_HTTP2_TLS_KEY=/ssl/key.pem \
  ghcr.io/ranuts/document:latest

SERVER_BASIC_AUTH takes a BCrypt hash; double the $ characters for shell escaping. Caching for the image is configured in sws.toml.

🔤 Fonts

The vendored OnlyOffice build ships its font library in public/fonts/, indexed by public/sdkjs/common/AllFonts.js. Fonts are fetched on demand — a document only pulls the ones it actually uses.

→ Font management guide — the indexed catalog's wire format, the registries, and adding fonts with bin/font-catalog.mjs.

🛠 Development

pnpm install --frozen-lockfile
pnpm run dev            # dev server
pnpm run build          # production build (bin/build.sh)
pnpm run lint           # oxlint + tsc + docker config
pnpm run test           # unit tests (Vitest)
pnpm run test:e2e       # end-to-end tests (Playwright, real editor + real WASM)

The end-to-end suite drives the real editor and the real converter rather than mocks, including document round trips, the embed protocol and the recovery flow. docs/explorations/ records why each non-obvious piece is the way it is — worth a look before changing the editor integration.

🤖 Browser AI agents (WebMCP)

Where the browser supports it, the page registers tools an in-browser agent can call directly instead of driving the UI: open_document_url, open_document_buffer, create_document, save_document, get_document_text, set_readonly, get_document_state. Documents still never leave the device — the browser fetches and converts them itself. Where the API is absent, this is a no-op.

📚 Built on

• sdkjs and web-apps — the OnlyOffice editors
• onlyoffice-x2t-wasm — the WASM document converter
• ranui / ranuts — the design system and utilities this site is built with
• se-office, onlyoffice-web-local — prior art for running OnlyOffice without a document server

🤝 Contributing

Issues and pull requests are welcome. main is protected: work on a branch and open a PR, which runs lint, unit tests and three end-to-end suites (dev server, Cloudflare Pages semantics, and the production Docker image).

📄 License

AGPL-3.0.

This project is a modified version of the ONLYOFFICE editors (sdkjs and web-apps, copyright Ascensio System SIA). Its interface uses neutral descriptions without product logos or promotional branding. Copyright, license, modification and source information remain available in the editor's About pane and in NOTICE. Third-party GUI assets and fonts retain their respective licenses; removing product marks does not change those licenses.

The decision to omit product logos follows the FSF's published interpretation of AGPLv3 Section 7. It is not described as a court ruling or a guarantee of legal compliance; the upstream position and the rationale are recorded in NOTICE.

ONLYOFFICE is a trademark of Ascensio System SIA. This project is not an official ONLYOFFICE product and is not affiliated with, sponsored by or endorsed by Ascensio System SIA. Names in legal notices and source references identify the upstream technology, not this project's brand.

PWA installation and browser tabs use an independently drawn, neutral document icon. It contains no upstream logo, trademark or project initials.