# Integrate in Astro

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

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

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.3`

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

---

Start with [installation and basic usage](https://docs.univer.ai/guides/bases/getting-started/installation.md). This example uses Astro to mount Univer Bases in a container with an explicit height.

Use a normal `<script>` to initialize the editor directly in the browser. Run initialization on the first load and on `astro:page-load`; dispose before `astro:before-swap` when using ClientRouter. Keep editor imports out of Astro frontmatter. See [Astro navigation events](https://docs.astro.build/en/reference/modules/astro-transitions/).

### Integration Steps

1. Initialize Univer in `mount()` / `astro:page-load`.
2. Dispose of Univer in `astro:before-swap`.

### Example

```astro title="src/pages/index.astro"
<div id="univer-bases" style="height: 600px"></div>

<script>
  import { UniverBasesPlugin } from '@univerjs-pro/bases'
  import { UniverBasesUIPlugin } from '@univerjs-pro/bases-ui'
  import BasesUIenUS from '@univerjs-pro/bases-ui/locale/en-US'
  import BasesenUS from '@univerjs-pro/bases/locale/en-US'
  import { UniverProFormulaEnginePlugin } from '@univerjs-pro/engine-formula'
  import { UniverLicensePlugin } from '@univerjs-pro/license'
  import { LocaleType, mergeLocales, Univer, UniverInstanceType } from '@univerjs/core'
  import DesignenUS from '@univerjs/design/locale/en-US'
  import { UniverRenderEnginePlugin } from '@univerjs/engine-render'
  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-pro/bases-ui/lib/index.css'

  let univerInstance: Univer | undefined

  function mount() {
    const container = document.getElementById('univer-bases')
    if (!container || univerInstance) return

    const univer = new Univer({
      locale: LocaleType.EN_US,
      locales: {
        [LocaleType.EN_US]: mergeLocales(
          DesignenUS,
          UIenUS,
          BasesenUS,
          BasesUIenUS,
        ),
      },
    })

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

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

    univer.createUnit(UniverInstanceType.UNIVER_BASE, {})
    univerInstance = univer
  }

  function dispose() {
    univerInstance?.dispose()
    univerInstance = undefined
  }

  mount()
  document.addEventListener('astro:page-load', mount)
  document.addEventListener('astro:before-swap', dispose)
</script>
```