Skip to content

Commit

Permalink
docs(repo): add section on filtering to include dependencies (vercel#…
Browse files Browse the repository at this point in the history
…9964)

### Description

Add a section in
[crafting-your-repository/running-tasks](https://turbo.build/repo/docs/crafting-your-repository/running-tasks)
on filtering to include dependencies.

Clarifies the use of `turbo dev --filter=web...` to limit the scope to
an app and its dependencies.

### Testing Instructions

N/A
  • Loading branch information
ddeltree authored and joshnuss committed Feb 15, 2025
1 parent 8fd7f06 commit afcd848
Showing 1 changed file with 7 additions and 0 deletions.
7 changes: 7 additions & 0 deletions docs/repo-docs/crafting-your-repository/running-tasks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,13 @@ When you're working on a specific package, you might want to run tasks for the p
turbo build --filter=...ui
```

### Filtering to include dependencies
To limit the scope to a package and its dependencies, append `...` to the package name. This runs the task for the specified package and all packages it depends on.

```bash title="Terminal"
turbo dev --filter=web...
```

### Filtering by source control changes

Using filters to run tasks based on changes in source control is a great way to run only the tasks for packages that are affected by your changes. **Source control filters must be wrapped in `[]`**.
Expand Down

0 comments on commit afcd848

Please sign in to comment.