---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../modules.md) / [cartridges](../index.md) / discoverCartridges

# Function: discoverCartridges()

> **discoverCartridges**(`root`, `host`, `options`): [`DiscoveredCartridge`](../interfaces/DiscoveredCartridge.md)[]

Defined in: [packages/b2c-tooling-sdk/src/cartridges/discover.ts:54](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/d7ff38c7ca2b1411cd718b9554500c9416f00266/packages/b2c-tooling-sdk/src/cartridges/discover.ts#L54)

Synchronously finds cartridges below `root` through a filesystem host.

A cartridge is a directory containing a `.project` file. The search does not
descend into a cartridge once found, skips [DISCOVERY\_IGNORED\_DIRECTORIES](../variables/DISCOVERY_IGNORED_DIRECTORIES.md),
and is depth-limited. Results are sorted by path for deterministic output.

Use this where only a synchronous host is available (for example inside the
TypeScript language service). Node callers that want project-root pruning and
warnings should use `findCartridges()` from `@salesforce/b2c-tooling-sdk/operations/code`.

## Parameters

### root

`string`

### host

[`CartridgeFileSystemHost`](../interfaces/CartridgeFileSystemHost.md)

### options

[`DiscoverCartridgesOptions`](../interfaces/DiscoverCartridgesOptions.md) = `{}`

## Returns

[`DiscoveredCartridge`](../interfaces/DiscoveredCartridge.md)[]
