Nuxt Module Development

nuxt

vue

Quick Start

npx nuxi init -t module my-module
cd my-module && npm install
npm run dev        # Start playground
npm run dev:build  # Build in watch mode
npm run test       # Run tests

Available Guidance

• references/development.md - Module anatomy, defineNuxtModule, Kit utilities, hooks
• references/testing-and-publishing.md - E2E testing, best practices, releasing, publishing
• references/ci-workflows.md - Copy-paste CI/CD workflow templates

Loading Files

• references/development.md - if building module features, using defineNuxtModule, or working with Kit utilities
• references/testing-and-publishing.md - if writing E2E tests, publishing to npm, or following best practices
• references/ci-workflows.md - if setting up CI/CD workflows for your module

Module Types

@nuxtjs/

nuxt-

modules/

nuxt.config.ts

Project Structure

my-module/
├── src/
│   ├── module.ts           # Entry point
│   └── runtime/            # Injected into user's app
│       ├── components/
│       ├── composables/
│       ├── plugins/
│       └── server/
├── playground/             # Dev testing
└── test/fixtures/          # E2E tests

Resources

• Module Guide
• Nuxt Kit
• Module Starter