> For AI agents: the complete documentation index is available at https://mfdoctor.kevinbeier.com/de/llms.txt, the full documentation bundle is available at https://mfdoctor.kevinbeier.com/de/llms-full.txt.

<!-- mfdoctor locale: de. Technische Bezeichner, CLI-Flags, Regel-IDs, Links und Codebeispiele bleiben byte-kompatibel mit dem kanonischen englischen Vertrag. -->

> Dies ist die deutsche mfdoctor-Dokumentation. Technische Bezeichner, CLI-Flags, Regel-IDs und Codebeispiele bleiben unverändert, damit die Inhalte zwischen den Sprachen vollständig kompatibel bleiben. Verwenden Sie den Sprachumschalter für die kanonische englische Fassung.

# One-rule CLI showcase

`examples/showcase` holds themed, intentional misconfigs for the **CLI**. Run
them to see the exact rule IDs mfdoctor reports one fixture at a time:

```bash
vp run demo:showcase
```

For **per-bundler build+mfdoctor** demos (Vite / Webpack / Rspack / Rsbuild, plus a
partial Modern.js stub), see
[standalone findings](https://mfdoctor.kevinbeier.com/de/standalone-findings.md) (`vp run demo:standalone`).

Prefer fixtures where a missing or weak config would still reach a Module
Federation plugin or build. Hard plugin failures (for example an empty `name`)
stay as rules, not showcases.

## Config

| Setup                      | Command                                                                                     | Finding                                           |
| -------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Expose key without `./`    | `node dist/cli.js check examples/showcase/config/expose-key-invalid --ci`                   | `config/expose-key-invalid` (error)               |
| Missing expose path        | `node dist/cli.js check examples/showcase/config/expose-path-missing --ci`                  | `config/expose-path-missing` (error)              |
| Invalid remote entry       | `node dist/cli.js check examples/showcase/config/remote-entry-invalid --ci`                 | `config/remote-entry-invalid` (error)             |
| Invalid filename           | `node dist/cli.js check examples/showcase/config/filename-invalid --ci`                     | `config/filename-invalid` (error)                 |
| Hashed remote filename     | `node dist/cli.js check examples/showcase/config/hashed-remote-filename --ci`               | `config/hashed-remote-filename` (warning)         |
| Undeclared share scope     | `node dist/cli.js check examples/showcase/config/share-scope-undeclared --ci`               | `config/share-scope-undeclared` (error)           |
| Insecure remote HTTP       | `node dist/cli.js check examples/showcase/config/remote-http-insecure --ci`                 | `config/remote-http-insecure` (warning)           |
| Local implementation       | `node dist/cli.js check examples/showcase/config/implementation-local --ci`                 | no findings (heuristic does not fire)             |
| Suspicious impl muted      | `node dist/cli.js check examples/showcase/config/implementation-suspicious-suppressed --ci` | no findings (`"off"`)                             |
| Localhost remotes in CI    | `node dist/cli.js check examples/showcase/config/remote-localhost-in-production --ci`       | `config/remote-localhost-in-production` (warning) |
| Alias prefix collision     | `node dist/cli.js check examples/showcase/config/remote-alias-prefix-collision --ci`        | `config/remote-alias-prefix-collision` (error)    |
| DTS outputDir mismatch     | `node dist/cli.js check examples/showcase/config/dts-output-dir-mismatch --ci`              | `config/dts-output-dir-mismatch` (warning)        |
| Alias overlapping shared   | `node dist/cli.js check examples/showcase/config/alias-share-bypass --ci`                   | `config/alias-share-bypass` (warning)             |
| Nested producer DTS        | `node dist/cli.js check examples/showcase/config/nested-producer-dts-extract --ci`          | `config/nested-producer-dts-extract` (warning)    |
| Nested producer DTS ok     | `node dist/cli.js check examples/showcase/config/nested-producer-dts-extract-ok --ci`       | no findings (`extractRemoteTypes: true`)          |
| Direct `.js` remotes + DTS | `node dist/cli.js check examples/showcase/config/js-remote-without-type-urls --ci`          | `config/js-remote-without-type-urls` (warning)    |

## Shared

| Setup                   | Command                                                                          | Finding                                        |
| ----------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------- |
| Eager without singleton | `node dist/cli.js check examples/showcase/shared/eager-without-singleton --ci`   | `shared/eager-without-singleton` (warning)     |
| Version unsatisfied     | `node dist/cli.js check examples/showcase/shared/version-unsatisfied --ci`       | `shared/version-unsatisfied` (error)           |
| Singleton risk          | `node dist/cli.js check examples/showcase/shared/singleton-risk --ci`            | `shared/singleton-risk` (warning)              |
| Singleton risk muted    | `node dist/cli.js check examples/showcase/shared/singleton-risk-suppressed --ci` | no findings (`"off"`)                          |
| Unused shared           | `node dist/cli.js check examples/showcase/shared/unused --ci`                    | `shared/unused` (warning)                      |
| Unused + unresolved dyn | `node dist/cli.js check examples/showcase/shared/unused-unresolved --ci`         | `doctor/partial-analysis` (no `shared/unused`) |
| Shared candidate        | `node dist/cli.js check examples/showcase/shared/candidate --ci`                 | `shared/candidate` (info)                      |
| Shared candidate muted  | `node dist/cli.js check examples/showcase/shared/candidate-suppressed --ci`      | no findings (`"off"`)                          |
| Deep-import bypass      | `node dist/cli.js check examples/showcase/shared/deep-import-bypass --ci`        | `shared/deep-import-bypass` (warning)          |

## Reliability

| Setup                         | Command                                                                                   | Finding                                               |
| ----------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Version-first offline remotes | `node dist/cli.js check examples/showcase/reliability/version-first-offline-remotes --ci` | `reliability/version-first-offline-remotes` (warning) |
| Shared `import: false`        | `node dist/cli.js check examples/showcase/reliability/shared-import-false --ci`           | `reliability/shared-import-false` (warning)           |

## Bridge

CLI/config-only Bridge fixtures (not full Bridge apps):

| Setup                  | Command                                                                   | Finding                               |
| ---------------------- | ------------------------------------------------------------------------- | ------------------------------------- |
| Missing `./export-app` | `node dist/cli.js check examples/showcase/bridge/export-app-missing --ci` | `bridge/export-app-missing` (warning) |
| Vue share missing      | `node dist/cli.js check examples/showcase/bridge/vue-share-missing --ci`  | `bridge/vue-share-missing` (error)    |

## Artifact

| Setup                     | Command                                                                          | Finding                                    |
| ------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------ |
| `react-dom/server` in web | `node dist/cli.js check examples/showcase/artifact/react-dom-server-in-web --ci` | `artifact/react-dom-server-in-web` (error) |

## SSR

| Setup                       | Command                                                                         | Finding                                   |
| --------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------- |
| Missing node runtime plugin | `node dist/cli.js check examples/showcase/ssr/node-runtime-plugin-missing --ci` | `ssr/node-runtime-plugin-missing` (error) |

## Runtime plugins

| Setup                          | Command                                                                                   | Finding                                               |
| ------------------------------ | ----------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Invalid plugin factory         | `node dist/cli.js check examples/showcase/runtime-plugins/invalid-factory --ci`           | `runtime-plugins/invalid-factory` (warning)           |
| createScript CORS without link | `node dist/cli.js check examples/showcase/runtime-plugins/create-script-cors-parity --ci` | `runtime-plugins/create-script-cors-parity` (warning) |

## Federation

| Setup                   | Command                                                                                             | Finding                                        |
| ----------------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| Version conflict        | `node dist/cli.js federation "examples/showcase/federation/version-conflict/*.project.json"`        | `federation/version-conflict` (error)          |
| Share scope mismatch    | `node dist/cli.js federation "examples/showcase/federation/share-scope-mismatch/*.project.json"`    | `federation/share-scope-mismatch` (error)      |
| Share strategy mismatch | `node dist/cli.js federation "examples/showcase/federation/share-strategy-mismatch/*.project.json"` | `federation/share-strategy-mismatch` (warning) |
| Circular remote graph   | `node dist/cli.js federation "examples/showcase/federation/circular-remote-graph/*.project.json"`   | `federation/circular-remote-graph` (warning)   |
| Singleton mismatch      | `node dist/cli.js federation "examples/showcase/federation/singleton-mismatch/*.project.json"`      | `shared/singleton-mismatch` (warning)          |
| Name conflict           | `node dist/cli.js federation "examples/showcase/federation/name-conflict/*.project.json"`           | `federation/name-conflict` (error)             |
| Missing provider        | `node dist/cli.js federation "examples/showcase/federation/missing-provider/*.project.json"`        | `federation/missing-provider` (error)          |
| Host gaps               | `node dist/cli.js federation "examples/showcase/federation/host-gaps/*.project.json"`               | `federation/host-gaps` (warning)               |
| Ghost shares            | `node dist/cli.js federation "examples/showcase/federation/ghost-shares/*.project.json"`            | `federation/ghost-shares` (info)               |

## Runtime

| Setup           | Command                                                                                                                                    | Finding                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- |
| Healthy trace   | `node dist/cli.js runtime examples/showcase/runtime/green/trace.json "examples/showcase/runtime/green/*.project.json"`                     | no findings (exit 0)              |
| Shared mismatch | `node dist/cli.js runtime examples/showcase/runtime/shared-mismatch/trace.json "examples/showcase/runtime/shared-mismatch/*.project.json"` | `runtime/shared-mismatch` (error) |

These directories are demo fixtures, not runnable apps. Keep
[mixed federation](https://mfdoctor.kevinbeier.com/de/mixed-example.md) for the healthy multi-bundler path,
[nested federation](https://mfdoctor.kevinbeier.com/de/nested-example.md) for multi-level orchestration,
[mixed federation issues](https://mfdoctor.kevinbeier.com/de/mixed-issues-example.md) for a red combination, and
[standalone findings](https://mfdoctor.kevinbeier.com/de/standalone-findings.md) for per-bundler build demos.
See [Examples](https://mfdoctor.kevinbeier.com/de/examples.md) for the full catalog.
