---
title: "nuxt build-module"
description: "Nuxt command to build your Nuxt module before publishing."
canonical_url: "https://nuxt.com/docs/4.x/api/commands/build-module"
---
# nuxt build-module

> Nuxt command to build your Nuxt module before publishing.

<!--build-module-cmd-->

```bash [Terminal]
npx nuxt build-module [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--build] [--stub] [--sourcemap] [--prepare]
```

<!--/build-module-cmd-->

The `build-module` command runs `@nuxt/module-builder` to generate `dist` directory within your `rootDir` that contains the full build for your **nuxt-module**.

## Arguments

<!--build-module-args-->

| Argument      | Description                                    |
| ------------- | ---------------------------------------------- |
| `ROOTDIR="."` | Specifies the working directory (default: `.`) |

<!--/build-module-args-->

## Options

<!--build-module-opts-->

| Option                               | Default | Description                                                                      |
| ------------------------------------ | ------- | -------------------------------------------------------------------------------- |
| `--cwd=<directory>`                  |         | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
| `--logLevel=<silent\|info\|verbose>` |         | Specify build-time log level                                                     |
| `--build`                            | `false` | Build module for distribution                                                    |
| `--stub`                             | `false` | Stub dist instead of actually building it for development                        |
| `--sourcemap`                        | `false` | Generate sourcemaps                                                              |
| `--prepare`                          | `false` | Prepare module for local development                                             |

<!--/build-module-opts-->

::read-more{to="https://github.com/nuxt/module-builder" icon="i-simple-icons-github" target="\_blank"}
Read more about `@nuxt/module-builder`.
::

---

- [Source](https://github.com/nuxt/module-builder/blob/main/src/cli.ts)


## Sitemap

See the full [sitemap](https://nuxt.com/sitemap.md) for all pages.