# sass-lookup

> Get the file associated with a Sass import

Latest version **7.0.0** (published 2026-05-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install sass-lookup
pnpm add sass-lookup
yarn add sass-lookup
bun add sass-lookup
```

Provides the command `sass-lookup`.

## Health

**Score 55/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 7.0.0 |
| Published | 2026-05-19 |
| First published | 2015-06-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=20.19.0 \|\| >=22.12.0 |
| Dependencies | 2 |
| Unpacked size | 8.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Joel Kemp |
| Maintainers | pahen, mrjoelkemp, xhmikosr |
| Keywords | sass, lookup, dependency, import, resolution |

## Links

- npm: https://www.npmjs.com/package/sass-lookup
- Repository: https://github.com/dependents/node-sass-lookup
- Issues: https://github.com/dependents/node-sass-lookup/issues
- npm.io page: https://npm.io/package/sass-lookup

## Dependencies (2)

- [commander](https://npm.io/package/commander.md) ^14.0.3
- [enhanced-resolve](https://npm.io/package/enhanced-resolve.md) ^5.21.5

## Recent versions

- 7.0.0 (latest) — 2026-05-19
- 6.1.2 — 2026-04-25
- 6.1.1 — 2026-03-15
- 6.1.0 — 2025-01-30
- 6.0.1 — 2024-04-10
- 6.0.0 — 2024-04-10
- 5.0.1 — 2023-05-13
- 5.0.0 — 2023-05-05
- 4.0.1 — 2023-04-24
- 4.0.0 — 2023-04-22
- 3.0.0 — 2018-11-18
- 2.0.0 — 2018-07-10
- 1.1.0 — 2017-08-26
- 1.0.2 — 2015-06-29
- 1.0.1 — 2015-06-28
- … 1 more at https://npm.io/package/sass-lookup/versions

## README

# sass-lookup

[![CI](https://img.shields.io/github/actions/workflow/status/dependents/node-sass-lookup/ci.yml?branch=main&label=CI&logo=github)](https://github.com/dependents/node-sass-lookup/actions/workflows/ci.yml?query=branch%3Amain)
[![npm version](https://img.shields.io/npm/v/sass-lookup?logo=npm&logoColor=fff)](https://www.npmjs.com/package/sass-lookup)
[![npm downloads](https://img.shields.io/npm/dm/sass-lookup)](https://www.npmjs.com/package/sass-lookup)

> Get the file associated with a Sass import

This module replaces the Sass compiler's lookup algorithm for resolving a partial's path.

* Handles underscored/non-underscored partials, partials with filenames, partials within subdirectories, partials with the `.scss` in the name, all of it.

*Originally built for [Dependents](https://github.com/dependents/Dependents)*

## Usage

### ESM

```js
import sassLookup from 'sass-lookup';

sassLookup({
  dependency: 'foo',
  filename: 'path/to/filename',
  directory: 'path/to/directory'
})
```

### CommonJS

```js
const { default: sassLookup } = require('sass-lookup');

sassLookup({
  dependency: 'foo',
  filename: 'path/to/filename',
  directory: 'path/to/directory'
});
```

* `dependency`: The partial's name
  * If your sass file had `@import "foo";`, then `"foo"` would be the dependency name
* `filename`: The file importing the dependency
* `directory`: The location(s) of all sass files
  * A list of multiple directories is also supported for this argument.

Example:

```js
import sassLookup from 'sass-lookup';

sassLookup({
  dependency: 'variables',
  filename: 'app/styles/styles.scss',
  directory: 'app/styles'
}); // yields app/styles/variables.scss
```

* This assumes that the file `app/styles/styles.scss` has `@import "variables";` and that all of the other sass files are located within `app/styles`.
* Would yield `app/styles/_variables.scss` if the partial had an underscored filename.

## CLI

Assumes a global install of sass-lookup with `npm install -g sass-lookup`

```sh
sass-lookup [options] path/to/file
```

Run `sass-lookup --help` to see all the options.

## License

[MIT](LICENSE)

---
_Source: https://npm.io/package/sass-lookup · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._