npmpackage.info

Gathering detailed insights and metrics for @shellscape/lilconfig

@shellscape/lilconfig - 3.2.1 | npmpackage.info

@shellscape/lilconfig

Zero-dependency nodejs config seeker.

3.2.1

173

MIT

JavaScript

1.49 kB

204,455 3.7

Installations

npm install @shellscape/lilconfig

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=14

Node Version

18.19.1

NPM Version

10.2.4 Score

71.1

Supply Chain

98.5

Quality

75.1

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

1

Total

45

Closed

8

Merged

36

Issues

Open

3

Total

15

Closed

12

Releases

v3.1.3 Windows friendly

v3.1.3

Updated on Dec 03, 2024

v3.1.2 Webpack friendly

v3.1.2

Updated on Jun 09, 2024

v3.1.1 Security release

v3.1.1

Updated on Feb 18, 2024

v3.1.0 Support ESM config files (async api only)

v3.1.0

Updated on Feb 14, 2024

v3.0.0 Cache support

v3.0.0

Updated on Nov 19, 2023

v2.1.0 adds support for `.config/<name>rc` files

v2.1.0

Updated on Mar 02, 2023

View All 14 releases

Languages

JavaScript

CoffeeScript

TypeScript

JavaScript (99.88%)

CoffeeScript (0.06%)

TypeScript (0.05%)

Developer

antonk52

Download Statistics

Total Downloads

204,455

Last Day

Last Week

Last Month

201

Last Year

204,336

GitHub Statistics

MIT License

173 Stars

139 Commits

10 Forks

2 Watchers

3 Branches

9 Contributors

Updated on Jun 29, 2025

Bundle Size

3.49 kB

Minified

1.49 kB

Minified + Gzipped

Bundlephobia

Sponsor this package

https://github.com/sponsors/antonk52

Maintainers

View All 9 Contributors

Package Meta Information

Latest Version

3.2.1

Package Id

@shellscape/lilconfig@3.2.1

Unpacked Size

13.16 kB

Size

4.83 kB

File Count

NPM Version

10.2.4

Node Version

18.19.1

Published on

May 10, 2024

Total Downloads

Cumulative downloads

Total Downloads

204,455

Last Day

-75%

Compared to previous day

Last Week

133.3%

Compared to previous week

Last Month

-99.4%

201

Compared to previous month

Last Year

171,610.9%

204,336

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@biomejs/biome @types/jest @types/node cosmiconfig jest typescript uvu

Lilconfig ⚙️

A zero-dependency alternative to cosmiconfig with the same API.

Installation

1npm install lilconfig

Usage

1import {lilconfig, lilconfigSync} from 'lilconfig';
2
3// all keys are optional
4const options = {
5    stopDir: '/Users/you/some/dir',
6    searchPlaces: ['package.json', 'myapp.conf.js'],
7    ignoreEmptySearchPlaces: false
8}
9
10lilconfig(
11    'myapp',
12    options // optional
13).search() // Promise<LilconfigResult>
14
15lilconfigSync(
16    'myapp',
17    options // optional
18).load(pathToConfig) // LilconfigResult
19
20/**
21 * LilconfigResult
22 * {
23 *   config: any; // your config
24 *   filepath: string;
25 * }
26 */

ESM

ESM configs can be loaded with async API only. Specifically js files in projects with "type": "module" in package.json or mjs files.

Difference to `cosmiconfig`

Lilconfig does not intend to be 100% compatible with cosmiconfig but tries to mimic it where possible. The key difference is no support for yaml files out of the box(lilconfig attempts to parse files with no extension as JSON instead of YAML). You can still add the support for YAML files by providing a loader, see an example below.

Options difference between the two.

cosmiconfig option	lilconfig
cache	✅
loaders	✅
ignoreEmptySearchPlaces	✅
packageProp	✅
searchPlaces	✅
stopDir	✅
transform	✅

Loaders examples

Yaml loader

If you need the YAML support you can provide your own loader

1import {lilconfig} from 'lilconfig';
2import yaml from 'yaml';
3
4function loadYaml(filepath, content) {
5    return yaml.parse(content);
6}
7
8const options = {
9    loaders: {
10        '.yaml': loadYaml,
11        '.yml': loadYaml,
12        // loader for files with no extension
13        noExt: loadYaml
14    }
15};
16
17lilconfig('myapp', options)
18    .search()
19    .then(result => {
20        result // {config, filepath}
21    });

Version correlation

lilconig v1 → cosmiconfig v6
lilconig v2 → cosmiconfig v7
lilconig v3 → cosmiconfig v8

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

8

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

6

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 6

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/coverage.yaml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/coverage.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/coverage.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/coverage.yaml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/coverage.yaml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/coverage.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:69: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:83: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/nodejs.yaml:85: update your workflow using https://app.stepsecurity.io/secureworkflow/antonk52/lilconfig/nodejs.yaml/master?enable=pin
Info: 0 out of 12 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 1 third-party GitHubAction dependencies pinned
Info: 5 out of 5 npmCommand dependencies pinned

1

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

3.7

/10

Last Scanned on 2025-06-23

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@shellscape/lilconfig

Installations

Developer Guide

Yes

CommonJS

>=14

18.19.1

10.2.4

Score

Pull Requests

1

45

8

36

Issues

3

15

12

Releases

Languages

Developer

antonk52

Download Statistics

GitHub Statistics

Bundle Size

3.49 kB

1.49 kB

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

204,455

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

Lilconfig ⚙️

Installation

Usage

ESM

Difference to cosmiconfig

Options difference between the two.

Loaders examples

Yaml loader

Version correlation

10

10

10

8

6

1

0

0

0

0

0

0

0

3.7

/10

Difference to `cosmiconfig`