Univer: 웹 앱에 스프레드시트·문서 편집기를 넣는 오피스 SDK
Univer는 웹 서비스 안에 엑셀 같은 스프레드시트와 워드 같은 문서 편집기를 직접 넣게 해 주는 TypeScript SDK예요. 편집, 화면 그리기, 수식 계산까지 이 저장소의 오픈소스 핵심(Apache-2.0)이 맡고, 차트·피벗 테이블·파일 변환·협업 서버 같은 기능은 별도 상용 모듈로 나뉘어 있어요. 오늘 GitHub 일간 트렌딩 1위였어요.
무엇을 해 주나요
- 시트 편집: 셀 서식, 병합, 떠 있는 이미지, 실행 취소·다시 실행, 수식, 이름 정의, 필터·정렬, 데이터 유효성 검사, 조건부 서식, 하이퍼링크, 메모, 찾기·바꾸기를 오픈소스로 제공해요.
- 문서 편집: 서식 있는 텍스트, 문단 서식, 목록, 링크, 메모, 그림 넣기를 다뤄요.
- 플러그인과 프리셋: 기능은 플러그인으로 하나씩 붙고, ‘프리셋’이 관련 플러그인과 API를 한 번에 등록해 줘요. 필요한 기능만 골라 번들 크기를 줄일 수 있는 구조예요.
- Facade API: 앱 코드는
FWorkbook,FWorksheet,FRange같은 객체로 시트를 다뤄요. 이벤트는univerAPI.Event로 받아요. - 명령과 실행 취소: 모든 변경은 ‘명령’으로 묶이고, 명령은 직렬화할 수 있는 내용 변경(mutation)과 일시적 상태 변경(operation)으로 나뉘어요. 각 기능이 정방향·역방향 변경을 함께 내놓아서 한 번의 실행 취소로 되돌릴 수 있어요.
- 스냅숏 저장:
workbook.save()가 JSON 스냅숏을 돌려주고, 저장 위치는 앱이 정해요. 다시 열 때는createWorkbook에 넘겨요.
README는 제품을 웹 SDK(오픈소스 핵심), 서버 SDK(협업, 편집 기록, 파일 가져오기·내보내기), AI SDK(오피스 기능을 에이전트에 연결) 세 부분으로 설명하는데, 이 저장소에 있는 것은 웹 SDK 핵심이에요.
설치와 사용
브라우저에서는 Vite 같은 번들러를 쓰고, 패키지 두 개를 설치해요.
pnpm add @univerjs/presets @univerjs/preset-sheets-core
README의 최소 예제는 이렇게 생겼어요. app이라는 id를 가진 요소가 먼저 있어야 해요.
const { univerAPI } = createUniver({
locale: LocaleType.EN_US,
locales: { [LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS) },
presets: [UniverSheetsCorePreset({ container: 'app' })],
})
univerAPI.createWorkbook({})
- 화면 없이 Node.js에서 돌릴 때는 Node.js 18.17.0 이상이 필요해요.
- 저장소를 직접 빌드하려면 Node.js 22.18 이상과
package.json에 적힌 pnpm 버전이 필요하고,pnpm install뒤pnpm dev로 실행해요. - 지원 브라우저 최소 버전은 Chrome·Edge 88, Firefox 90, Safari 14.1, Electron 12예요.
Intl.Segmenter가 없는 환경은 폴리필이 필요해요. - React 18·19를 지원하고, 16.9 이상·17은 최소 지원이에요. Webpack 4는 경로 설정을 더 해야 할 수 있어요.
누구에게 쓸모 있나요
사내 시스템이나 SaaS에 견적서, 정산표, 보고서처럼 ‘엑셀 비슷한 화면’을 넣어야 하는 팀에 맞아요. 셀에 값과 수식을 넣고 계산이 끝나길 기다린 뒤 스냅숏을 저장하는 예제가 README에 있어서, 서버에서 문서를 자동으로 채우는 용도도 가늠해 볼 수 있어요.
쓰기 전에 알아 둘 점
- 오픈소스와 상용의 경계: 차트, 도형, 피벗 테이블, SmartArt 같은 플러그인과 XLSX·DOCX·PPTX 가져오기·내보내기, 슬라이드, 보드는 따로 배포되는 상용 기능이에요. 무료 평가판에는 워터마크와 기능 제한이 있다고 적혀 있고, 가격은 README에 없어요.
- 버전 맞추기: 상용 패키지는 오픈소스 패키지와 같은 릴리스 계열이어야 하고,
@univerjs/*패키지는 모두 같은 버전으로 맞추라고 해요. - 빠른 변경: 11월 7일 v1.4.0, 14일 v1.5.0, 16일 v1.5.1이 나왔어요. v1.5.0에서는 1.4.0에서 예고한 Worker 루트 내보내기를 없앴기 때문에, 직접 만든 Worker 스크립트는
/worker진입점을 써야 해요. - 내부 확장 지점은 API 안정성 정책의 적용을 받아서, 내부 구현에 기대면 업그레이드 때 깨질 수 있다고 README가 경고해요. 일부 연동(WorkBuddy, Web App × Sheet)은 개발자 미리보기·실험 단계예요.
- 텔레메트리에 관한 설명은 README에 없어요.
저장소 상태
- 별 26.7k, 포크 2.4k (GitHub 표시값)
- 열린 이슈 90개, 풀 리퀘스트 85개
- 언어: TypeScript (트렌딩 페이지의 주 언어 표시)
- 라이선스: Apache-2.0 (오픈소스 패키지 기준, 상용 모듈은 별도 라이선스)
- 마지막 커밋: 2026년 11월 16일 (“release v1.5.2” 커밋). 같은 날 두 번째 번들 난독화 단계를 없애는 빌드 수정도 들어갔어요.
- 최신 릴리스: 릴리스 페이지 기준 v1.5.1(11월 16일). 커밋 기록에는 v1.5.2 릴리스 커밋이 있지만, 확인 시점 릴리스 페이지에는 아직 보이지 않았어요.
- 최상위 폴더:
packages,presets,examples,docs,tests/formula-integration등. README가 말하는 플러그인·프리셋 구조와 맞아요.
확인 범위
- GitHub 웹 페이지로 확인(API 미사용). 확인한 날짜: 2026년 11월 16일.
- 읽은 페이지: 저장소 첫 화면과 README, 릴리스 페이지, 커밋 페이지, 이슈 페이지
- 읽지 못했거나 하지 않은 것: 코드 분석, 설치·실행, 상용 모듈과 univer.ai 가격 페이지
출처: dream-num/univer, 릴리스, 커밋 기록