npmpackage.info

Gathering detailed insights and metrics for lilconfig

Other packages similar to lilconfig

@sliphua/lilconfig-ts-loader

3.2.2

A TypeScript loader for lilconfig

@tylerbu/lilconfig-loader-ts

0.1.2

A loader that enables loading TypeScript files in lilconfig.

@shellscape/lilconfig

3.2.1

A zero-dependency alternative to cosmiconfig

Gathering detailed insights and metrics for lilconfig

lilconfig - 3.1.3 | npmpackage.info

lilconfig

Zero-dependency nodejs config seeker.

3.1.3

176

MIT

JavaScript

17.54 kB

3.7

Installations

npm install lilconfig

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=14

Node Version

23.3.0

NPM Version

10.8.1 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

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

176 Stars

139 Commits

10 Forks

2 Watchers

3 Branches

9 Contributors

Updated on Jul 14, 2025

Sponsor this package

https://github.com/sponsors/antonk52

Maintainers

View All 9 Contributors

Package Meta Information

Latest Version

3.1.3

Package Id

lilconfig@3.1.3

Unpacked Size

17.54 kB

Size

5.10 kB

File Count

NPM Version

10.8.1

Node Version

23.3.0

Published on

Dec 03, 2024

Total Downloads

Cumulative downloads

Total Downloads

NaN

Dev Dependencies

@biomejs/biome @types/jest @types/node @types/webpack-env 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

High

8.8/10

Summary

lilconfig Code Injection vulnerability

Affected Versions

>= 3.1.0, < 3.1.1

Patched Versions

3.1.1

10

Dangerous-Workflow

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

10

Binary-Artifacts

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

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: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
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
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-07-07

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

Other packages similar to lilconfig

Other packages similar to lilconfig

lilconfig

Installations

Developer Guide

Yes

CommonJS

>=14

23.3.0

10.8.1

Pull Requests

1

45

8

36

Issues

3

15

12

Releases

Languages

Developer

antonk52

Download Statistics

GitHub Statistics

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

NaN

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

Weekly Downloads

Monthly Downloads

Yearly Downloads

Difference to `cosmiconfig`