---
title: モノレポで使う
sidebar:
  order: 1
---

`groups` オプションがないとき、svelte-zukan は次の順にカタログファイルを探します。

1. Vite の root にあるパッケージ（カタログ用のアプリ自身）の `src`
2. そのアプリが依存しているワークスペースパッケージの `src`（アプリの `package.json` の `dependencies`、`devDependencies` の順）

グループ名はパッケージの `package.json` の `name` です。`name` がなければディレクトリ名です。カタログファイルがないパッケージはグループになりません。

## 依存パッケージの見つけ方

依存パッケージはカタログ用のアプリ自身の `node_modules/<依存名>`（pnpm）か、ワークスペースのルートの `node_modules/<依存名>`（npm、yarn、bun）にあるリンクから探します。

- Yarn の Plug'n'Play には `node_modules` がないので見つかりません。その場合は `groups` で指定してください
- 推移的な依存は探しません。アプリの依存に宣言していないアプリやパッケージは、`groups` で指定します

## 各パッケージにインストールする

カタログファイルは `svelte-zukan` から `Section` を import します。そのため、カタログファイルを置くパッケージにはそれぞれ、カタログ用のアプリと同じバージョンの `svelte-zukan` を `devDependencies` に入れます。pnpm では、パッケージは自分が宣言したものしか import できません。入れないと、dev サーバーではそのパッケージのカタログファイルが表示されることがあっても、[`build: true`](/svelte-zukan/ja/static-export) での `vite build` は `svelte-zukan` を解決できずに失敗します。

## `groups` でディレクトリを選ぶ

`groups` を書くと自動探索はせず、書いたディレクトリだけを探します。たとえば、カタログ用のアプリ `apps/catalog` から、別のアプリ `apps/web` のコンポーネントを見せたいときは次のようにします。

```ts
// apps/catalog/vite.config.ts
zukan({
  groups: {
    web: '../web/src',
    ui: '../../packages/ui/src'
  }
});
```

パスは Vite の root からの相対パスです。1 つのグループに複数のディレクトリを並べることもできます（`{ examples: ['src/examples', 'src/demo'] }`）。
