A full-stack, isomorphic office SDK for building spreadsheets, documents, and presentations.

Build embeddable productivity experiences with a plugin architecture, Canvas-based rendering, a formula engine, and one Facade API that works in the browser and on Node.js.

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español

📖 Documentation | ✨ Showcase | 📘 API Reference | 📝 Blog

This fork adds right-to-left (RTL) rendering for Arabic — and any RTL script — at the rendering-engine level. It is developed and maintained by Riyadh Ali (github.com/riyadhali/univer-rtl), with AI-agent contributions in testing, documentation, and review.

• Visual-order text engine — a dependency-free BiDi processor in @univerjs/engine-render (src/basics/rtl-processor.ts) plus layout hooks that re-order glyph runs per line into visual order. Base direction is resolved per line: any RTL character makes the line RTL (a Latin-leading fragment such as GLM-5.3-Flash.. still paints at the right edge, like Word with an RTL paragraph); pure-Latin lines stay LTR even inside Arabic documents; empty/weak lines (, "(", digits) inherit the document locale direction (ar-SA → RTL) and then the nearest preceding strong paragraph, so pressing Enter inside an Arabic paragraph keeps the new line RTL.
• Arabic shaping integrity — an Arabic word is shaped as ONE glyph painted with a single fillText, so the browser performs full OpenType joining and diacritics; words are never split letter-by-letter after punctuation. Backspace/Delete remove exactly one character (surrogate-pair aware), never the whole merged word-glyph.
• Bidi rules & bracket mirroring — UAX #9 resolution with numeric/weak handling for mixed content (e.g. 12:30, 1,000, 94%, Arabic punctuation ، ٫ ٬), and L4 drawn-shape mirroring (brackets, quotes) through a paint-only rtlVisualContent field — the logical content stays authoritative for hit-testing and selection.
• Selection & caret geometry — a multi-glyph selection paints as one visual block over the full glyph extent regardless of languages inside; a collapsed caret mirrors to the side of the surrounding glyph. Painting only — logical offsets and selection state are never modified.
• Editing reliability in Docs — body, page headers and footers (Chrome and Firefox) — the model-side selection is the single source of truth for where the next typed character belongs (immune to stale skeleton-derived render ranges); insert mutations advance the caret synchronously and carry the header/footer segmentId, so fast mixed Arabic/Latin typing never scrambles letters, Enter inside a header stays inside the header, and deleting a selection (Select All + Delete) no longer crashes.
• Firefox compatibility — the document layout Worker's capability check tolerates Firefox's whole-pixel OffscreenCanvas glyph quantization (relative tolerance instead of a fixed 1px floor), so a perfectly healthy Worker is no longer rejected; RTL presentation remains owned by the engine-render layer, and Worker layout sessions run on the proven LTR path.

The implementation lives in @univerjs/engine-render (src/basics/rtl-processor.ts, src/components/docs/layout/block/paragraph/line-adjustment.ts, language-ruler.ts, extensions/font-and-base-line.ts) with hooks in the Docs layout, selection/caret geometry (docs-ui), the Docs editing commands/mutations, and the layout-Worker service. Full technical documentation, change log, and known limitations: RTL_SUPPORT.md.

• Docs: full RTL support — body, page headers, and footers, in Chrome and Firefox.
• Sheets: Arabic text in cells, the cell editor, and the formula bar follows the same engine path; a full right-to-left sheet (worksheet-level column mirroring from rightToLeft) is not yet implemented.
• Slides: text boxes share the Docs text engine; the upstream table-insert flow into a slide text frame is still broken upstream.

Run the examples workbench (pnpm dev in examples/), open the Docs example, and switch the workbench direction/locale to RTL (العربية / ar-SA) — the document, its header/footer areas, and the editing experience run in RTL end-to-end.

Univer is an open-source SDK for creating office applications inside your own product. It gives you the building blocks for spreadsheet, document, and presentation experiences without forcing you into a hosted app or a fixed UI.

Use Univer when you need to:

• Embed spreadsheet or document editing into a SaaS product, internal tool, BI workflow, or AI application.
• Run workbook/document processing on the server with the same architecture used in the browser.
• Compose only the features you need through plugins or start quickly with presets.
• Extend behavior through custom plugins, commands, services, UI components, and Facade APIs.

Univer is not a spreadsheet file viewer only. It is a framework for building your own productivity surface.

• Isomorphic by design: run UI apps in browsers and headless processing in Node.js.
• Plugin-first architecture: every capability is delivered as a composable plugin, so features can be added, removed, replaced, or lazy-loaded.
• Preset mode for fast integration: use the curated plugin collections in presets/ when you want a working app quickly.
• Plugin mode for full control: manually compose packages when you need custom loading, smaller bundles, or deep integration.
• Facade API: work with workbooks, worksheets, ranges, documents, formulas, commands, and events through a higher-level API.
• Canvas rendering engine: support large editable document surfaces with a rendering layer shared across document types.
• Extensible UI: integrate with React, Vue, Web Components, and framework-specific application shells.

Use Plugin Mode for complete product coverage and precise composition. For supported Sheets, Docs, and Node profiles, Preset Mode provides a shorter curated setup.

pnpm add @univerjs/core @univerjs/design @univerjs/docs @univerjs/docs-ui @univerjs/engine-formula @univerjs/engine-render @univerjs/sheets @univerjs/sheets-formula @univerjs/sheets-formula-ui @univerjs/sheets-numfmt @univerjs/sheets-numfmt-ui @univerjs/sheets-ui @univerjs/ui

import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
import { FUniver } from '@univerjs/core/facade'
import DesignEnUS from '@univerjs/design/locale/en-US'
import { UniverDocsPlugin } from '@univerjs/docs'
import { UniverDocsUIPlugin } from '@univerjs/docs-ui'
import DocsUIEnUS from '@univerjs/docs-ui/locale/en-US'
import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
import { UniverSheetsPlugin } from '@univerjs/sheets'
import SheetsEnUS from '@univerjs/sheets/locale/en-US'
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula'
import SheetsFormulaEnUS from '@univerjs/sheets-formula/locale/en-US'
import { UniverSheetsFormulaUIPlugin } from '@univerjs/sheets-formula-ui'
import SheetsFormulaUIEnUS from '@univerjs/sheets-formula-ui/locale/en-US'
import { UniverSheetsNumfmtPlugin } from '@univerjs/sheets-numfmt'
import { UniverSheetsNumfmtUIPlugin } from '@univerjs/sheets-numfmt-ui'
import SheetsNumfmtUIEnUS from '@univerjs/sheets-numfmt-ui/locale/en-US'
import { UniverSheetsUIPlugin } from '@univerjs/sheets-ui'
import SheetsUIEnUS from '@univerjs/sheets-ui/locale/en-US'
import { UniverUIPlugin } from '@univerjs/ui'
import UIEnUS from '@univerjs/ui/locale/en-US'

import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs/docs-ui/lib/index.css'
import '@univerjs/sheets-ui/lib/index.css'
import '@univerjs/sheets-formula-ui/lib/index.css'
import '@univerjs/sheets-numfmt-ui/lib/index.css'

import '@univerjs/engine-formula/facade'
import '@univerjs/ui/facade'
import '@univerjs/sheets/facade'
import '@univerjs/sheets-ui/facade'
import '@univerjs/sheets-formula/facade'
import '@univerjs/sheets-numfmt/facade'

const univer = new Univer({
  locale: LocaleType.EN_US,
  locales: {
    [LocaleType.EN_US]: mergeLocales(
      DesignEnUS,
      UIEnUS,
      DocsUIEnUS,
      SheetsEnUS,
      SheetsUIEnUS,
      SheetsFormulaEnUS,
      SheetsFormulaUIEnUS,
      SheetsNumfmtUIEnUS,
    ),
  },
})

univer.registerPlugin(UniverRenderEnginePlugin)
univer.registerPlugin(UniverFormulaEnginePlugin)
univer.registerPlugin(UniverUIPlugin, { container: 'app' })
univer.registerPlugin(UniverDocsPlugin)
univer.registerPlugin(UniverDocsUIPlugin)
univer.registerPlugin(UniverSheetsPlugin)
univer.registerPlugin(UniverSheetsUIPlugin)
univer.registerPlugin(UniverSheetsFormulaPlugin)
univer.registerPlugin(UniverSheetsFormulaUIPlugin)
univer.registerPlugin(UniverSheetsNumfmtPlugin)
univer.registerPlugin(UniverSheetsNumfmtUIPlugin)

const univerAPI = FUniver.newAPI(univer)
univerAPI.createWorkbook({})

pnpm add @univerjs/presets @univerjs/preset-sheets-core

import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'

import '@univerjs/preset-sheets-core/lib/index.css'

const { univerAPI } = createUniver({
  locale: LocaleType.EN_US,
  locales: {
    [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
  },
  presets: [
    UniverSheetsCorePreset({
      container: 'app',
    }),
  ],
})

univerAPI.createWorkbook({})

Your page needs a container:

<div id="app" style="height: 100vh"></div>

Learn more in the Installation & Basic Usage guide, the createUniver reference, and the Facade API reference.

Keep the @univerjs/* SDK packages in the same coordinated Univer release line on the same version. Independently released packages, including @univerjs/icons and @univerjs/icons-svg, use the compatible versions declared by package manifests instead of the SDK version. If you use Univer Pro packages, keep @univerjs-pro/* aligned with the matching coordinated release line.

For API compatibility expectations, experimental APIs, internal APIs, and deprecation rules, see the API Stability Policy.

• Browser runtime: Univer is compiled with a Chrome 88 target and aims to work on Edge >=88, Firefox >=90, Chrome >=88, Safari >=14.1, and Electron >=12.
• Polyfills: Univer relies on Intl.Segmenter. Add a polyfill such as @formatjs/intl-segmenter if your target browser or runtime does not provide it.
• Build tools: We recommend Vite, esbuild, or Webpack 5. If your build tool does not support the exports field in package.json (common in Webpack 4), you may need extra path mapping.
• React: Univer's view layer is built on React 18, supports React 18 and 19, and provides minimal compatibility support for React 16.9+ and 17.
• Node.js runtime: Headless Univer supports Node.js >=18.17.0. Developing this monorepo requires Node.js >=22.18.

Sheets are the most mature product surface today. Docs and Slides share Univer's architecture and continue to evolve in the same SDK.

This repository contains Univer's open-source core and first-party OSS plugins. Univer Pro is developed separately as a commercial extension layer for advanced product surfaces, collaboration, server features, and enterprise integrations.

Pro features are documented in the Univer Pro guide. They are intentionally separated here so the OSS package surface is clear.

Boundary principles:

• OSS packages in this repository are intended to be useful on their own under the Apache-2.0 license. Univer Pro is optional and is not required to use the public OSS SDK APIs.
• Bugs, regressions, and security issues in OSS packages should be reported and fixed in the OSS repository, even when a related Pro feature exists.
• OSS documentation should not imply that Pro-only capabilities are available in public @univerjs/* packages. Pro-only APIs, packages, and deployment paths should be named explicitly.
• When an OSS feature has a Pro enhancement, the OSS behavior should remain documented independently so users can evaluate the open-source surface without reading commercial docs first.

• Core SDK: dream-num/univer, this monorepo.
• Presets: this repository's presets/, curated plugin collections for browser and Node.js apps.
• AI agent skills: dream-num/univer-sdk-skills, reusable instructions for AI agents working with Univer integration, Pro features, plugin development, and Node backends. See the AI Skills guide.
• Documentation: docs.univer.ai, including Sheets, Docs, Slides, recipes, and Pro guides.
• API Reference: docs.univer.ai/reference, the Facade API and generated API reference.
• Examples and showcase: Univer Showcase and this repository's examples/.
• AI-native spreadsheets: dream-num/univer-mcp, Univer Platform / MCP integration for driving Univer Sheets with natural language.

.
├── packages/      Core packages, engines, document types, UI plugins, and feature plugins
├── examples/      All-in-one Vite workbench used for local browser development
├── common/        Shared internal tooling, storybook, and utilities
├── tests/         Additional integration test projects
└── docs/          Architecture notes, images, and repository-local documentation

Package-level READMEs live beside each package under packages/.

Requirements:

• Node.js >=22.18
• pnpm >=11

git clone https://github.com/dream-num/univer.git
cd univer
pnpm install
pnpm dev

Useful commands:

Read CONTRIBUTING.md before opening a pull request.

Repository-local notes worth reading before deeper changes:

• Building Isomorphic Univer: how to split browser, Node.js, UI, and shared plugin logic.
• API Stability Policy: stable, experimental, internal, deprecated, and breaking-change expectations.
• Contributing to Facade API: API design expectations for FUniver, FWorkbook, FRange, and related Facade classes.
• Naming Convention: file, folder, interface, plugin, command, and dependency injection token conventions.
• Fixing Memory Leaks: common leak patterns and debugging workflow for Univer instances.
• Architecture TLDRs: concise notes for formula engine, web worker, permission, selection, and ref-range behavior.

• Ask questions in GitHub Discussions.
• Chat with the community on Discord.
• Follow Twitter / X and YouTube.

Please read the Code of Conduct before participating.

If you believe you have found a security issue, please follow the Security Policy.

Univer is supported by the community and sponsors. You can support the project through Open Collective.

Copyright (c) 2021-present DreamNum Co., Ltd.

Licensed under the Apache-2.0 license.