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

[@salesforce/b2c-tooling-sdk](../../../modules.md) / [operations/code](../index.md) / findCartridges

# Function: findCartridges()

> **findCartridges**(`directory?`, `options?`): [`CartridgeMapping`](../interfaces/CartridgeMapping.md)[]

Defined in: [packages/b2c-tooling-sdk/src/operations/code/cartridges.ts:56](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/e7c16f1ae423da0aa47b3e10be88f9770b53619b/packages/b2c-tooling-sdk/src/operations/code/cartridges.ts#L56)

Find cartridges recursively in a directory.

Cartridges are identified by the presence of a `.project` file
(Eclipse project marker commonly used in SFCC development).

## Parameters

### directory?

`string`

Directory to search for cartridges (defaults to cwd)

### options?

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

Filter options for including/excluding cartridges

## Returns

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

Array of discovered cartridge mappings

## Example

```typescript
// Find all cartridges in current directory
const cartridges = findCartridges();

// Find cartridges in specific directory
const cartridges = findCartridges('./my-project');

// Find specific cartridges only
const cartridges = findCartridges('.', { include: ['app_storefront_base'] });

// Find all except certain cartridges
const cartridges = findCartridges('.', { exclude: ['test_cartridge'] });
```