JoyCon is a zero-dependency Node.js utility for finding and loading configuration files named by a list (for example, lockfiles). It searches for matching files, resolves the found file path, parses the file contents (JSON by default), and can use custom loaders for other formats like TOML.
Project status
- The GitHub source appears quiet and likely in maintenance mode: the last recorded upstream push was in 2023-01-07, and the most recent tagged updates shown are from late 2021.
- Apparent update cadence is long-stalled, with no evidence of active, recent development relative to today (2026-08-12).
AI summary generated
Recent updates
v3.1.1
v3.1.1 changes JoyCon's default file loading behavior to parse file contents as JSON by default, simplifying the loader logic. The README was updated to reflect that non-JS files are now treated as JSON rather than being returned as raw data.
v3.1.0
v3.1.0 adds support for loading CommonJS .cjs files instead of treating them as unparsed/raw content. The default loader behavior was updated to recognize the .cjs extension and require it like .js.
Featuresv3.0.1
Release v3.0.1 primarily updates the project to support Node.js 10 and modernizes CI configuration. The release notes only mention Node 10 support, but the diff also introduces new GitHub Actions workflow automation and changes CircleCI to use a pinned Node 10 image.
v3.0.0
v3.0.0 is a major release that raises the minimum supported Node version to Node 12+. The codebase was also refactored heavily (async traversal and caching logic, loader management), and typings and tests were updated accordingly.
BreakingFeaturesv2.1.0
v2.1.0 adds support for passing a single options object directly to the `.resolve([options])` and `.load([options])` methods. This improves call-site ergonomics by allowing an object argument without wrapping it in an array.
Features