Monorepos

Run the layer inside the repository of Mirror or Vue Equipment, against the source rather than a published copy.

The layer runs on @maas/mirror and @maas/vue-equipment. Inside the repository of either one, the docs should run on the code next to them rather than on a release from npm. Two mechanisms make that work: peer dependencies for the packages, and aliases for the source.

Packages

Both libraries are peer dependencies of the layer, so the docs app provides them. Declare the workspace package, and pnpm hands the layer the same copy.

apps/docs/package.json

{
  "dependencies": {
    "@maas/docs": "^0.1.0",
    "@maas/mirror": "workspace:*",
    "@maas/vue-equipment": "workspace:*"
  }
}

Source

Nuxt resolves a module name through alias before it loads the module, and it installs a module once per resolved path. An alias for @maas/vue-equipment/nuxt therefore replaces the copy the layer registers instead of adding a second one.

apps/docs/nuxt.config.ts

import { fileURLToPath } from 'node:url'

const packages = fileURLToPath(new URL('../../packages', import.meta.url))

export default defineNuxtConfig({
  extends: ['@maas/docs'],

  alias: {
    '@maas/vue-equipment/nuxt': `${packages}/nuxt/src/module`,
    '@maas/vue-equipment/plugins': `${packages}/plugins`,
    '@maas/vue-equipment/composables': `${packages}/composables`,
    '@maas/vue-equipment/utils': `${packages}/utils`,
  },

  vueEquipment: {
    plugins: true,
    composables: true,
  },
})

The same aliases reach the layer’s own imports, so the search palette and the drawer run on the plugin source as well. Your vueEquipment options take precedence over the plugins the layer registers.

Tokens

To document the tokens the repository builds, point docs.tokens at its .maas directory. Demos that live in packages need their directories scanned by Tailwind and matched by docs.previews.

apps/docs/nuxt.config.ts

export default defineNuxtConfig({
  extends: ['@maas/docs'],
  docs: {
    tokens: '../../.maas',
    sources: ['../../packages/plugins'],
    previews: ['../../packages/plugins/*/demo/*.vue'],
  },
})

Pages

Pages documented next to their source join the collection through source.

apps/docs/content.config.ts

import { fileURLToPath } from 'node:url'
import {
  defineContentConfig,
  defineDocsCollections,
} from '@maas/docs/content'

const plugins = fileURLToPath(new URL('../../packages/plugins', import.meta.url))

export default defineContentConfig({
  collections: defineDocsCollections({
    source: [
      { include: '0.overview/*.md' },
      {
        cwd: plugins,
        include: '*/index.md',
        prefix: '/1.plugins',
        exclude: ['**/node_modules/**'],
      },
    ],
  }),
})