# Next.js에 통합

- Human documentation: [https://docs.univer.ai/ko-KR/guides/bases/getting-started/integrations/nextjs](https://docs.univer.ai/ko-KR/guides/bases/getting-started/integrations/nextjs)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/bases/getting-started/integrations/nextjs.md](https://docs.univer.ai/ko-KR/guides/bases/getting-started/integrations/nextjs.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [bases/getting-started/integrations/nextjs.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/bases/getting-started/integrations/nextjs.ko-KR.mdx)

---

먼저 [설치 및 기본 사용법](https://docs.univer.ai/ko-KR/guides/bases/getting-started/installation.md)을 읽으세요. 아래 예제는 Next.js App Router를 사용해 높이가 명시된 컨테이너에 Univer Bases를 마운트합니다.

클라이언트 컴포넌트에서 `ssr: false`[^ssr]로 동적 로딩합니다. `use client`만으로는 사전 렌더링이 비활성화되지 않습니다. [Next.js](https://nextjs.org/docs/app/guides/lazy-loading#skipping-ssr).

`YOUR_CLIENT_LICENSE`를 클라이언트 라이선스 내용으로 바꿉니다. 파일 경로를 사용하지 마세요. [라이선스 설정](https://docs.univer.ai/ko-KR/server/license.md).

### 통합 단계

1. `useEffect`에서 Univer를 초기화합니다.
2. `useEffect cleanup`에서 Univer를 해제합니다.

### 예제 코드

마운트마다 별도의 자식 컨테이너를 사용합니다. 바깥 React 정리가 끝난 뒤 마이크로태스크에서 인스턴스를 폐기하여 React 커밋 중 중첩 루트의 동기 언마운트를 방지합니다.

```tsx title="univer-editor.tsx"
'use client'

import { useEffect, useRef } from 'react'
import { UniverBasesPlugin } from '@univerjs-pro/bases'
import { UniverBasesUIPlugin } from '@univerjs-pro/bases-ui'
import BasesUIkoKR from '@univerjs-pro/bases-ui/locale/ko-KR'
import BaseskoKR from '@univerjs-pro/bases/locale/ko-KR'
import { UniverProFormulaEnginePlugin } from '@univerjs-pro/engine-formula'
import { UniverLicensePlugin } from '@univerjs-pro/license'
import { LocaleType, mergeLocales, Univer, UniverInstanceType } from '@univerjs/core'
import DesignkoKR from '@univerjs/design/locale/ko-KR'
import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
import { UniverUIPlugin } from '@univerjs/ui'
import UIkoKR from '@univerjs/ui/locale/ko-KR'

import '@univerjs/design/lib/index.css'
import '@univerjs/ui/lib/index.css'
import '@univerjs-pro/bases-ui/lib/index.css'

export default function UniverEditor() {
  const containerRef = useRef<HTMLDivElement>(null)

  useEffect(() => {
    const host = containerRef.current
    if (!host) return
    const container = document.createElement('div')
    container.style.height = '100%'
    host.append(container)

    const univer = new Univer({
      locale: LocaleType.KO_KR,
      locales: {
        [LocaleType.KO_KR]: mergeLocales(
          DesignkoKR,
          UIkoKR,
          BaseskoKR,
          BasesUIkoKR,
        ),
      },
    })

    univer.registerPlugin(UniverLicensePlugin, {
      license: 'YOUR_CLIENT_LICENSE',
    })
    univer.registerPlugin(UniverRenderEnginePlugin)
    univer.registerPlugin(UniverUIPlugin, { container })

    univer.registerPlugin(UniverProFormulaEnginePlugin)
    univer.registerPlugin(UniverBasesPlugin)
    univer.registerPlugin(UniverBasesUIPlugin)

    univer.createUnit(UniverInstanceType.UNIVER_BASE, {})

    return () => {
      queueMicrotask(() => {
        univer.dispose()
        container.remove()
      })
    }
  }, [])

  return <div ref={containerRef} style={{ height: 600 }} />
}
```

```tsx title="page.tsx"
'use client'

import dynamic from 'next/dynamic'

const UniverEditor = dynamic(() => import('./univer-editor'), { ssr: false })

export default function Page() {
  return <UniverEditor />
}
```

[^ssr]: 서버 사이드 렌더링(SSR)은 브라우저가 페이지를 로드하기 전에 렌더링 코드를 실행합니다. 이 환경에는 `window`와 DOM이 없습니다. Client Component도 사전 렌더링될 수 있으므로 편집기 컴포넌트의 SSR을 별도로 꺼야 합니다.