# jonaskello/tsconfig-paths

Load node modules according to tsconfig paths, in run-time or via API.

Repository: https://github.com/jonaskello/tsconfig-paths
Canonical: https://ross.abutalabs.com/products/tsconfig-paths
Language: TypeScript
License: MIT
License Family: permissive
Topics: tsconfig-paths, typescript, tsconfig
Last push: 2026-02-23T07:34:11+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 69, release rhythm 35, longevity 100
- inputs: {"age_days": 3533, "days_push": 191, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1905, forks 107 (observed 2026-08-28T04:05:51.897575+00:00)

## What it is
A TypeScript library that resolves Node.js module loading according to the paths mapping defined in tsconfig.json or jsconfig.json, at runtime or via API. It hooks into Node's module resolution so compiled or ts-node-executed code can use path aliases that Node would otherwise not find.

## Use cases
- run node scripts that use tsconfig path aliases
- make ts-node resolve @-prefixed import paths
- register path mapping for mocha tests written in TypeScript
- resolve tsconfig paths at runtime via API
- avoid relative import paths in TypeScript projects

## When to choose
- you use tsconfig paths aliases and run code with node or ts-node
- you need runtime module resolution matching your TypeScript path mapping
- you want a --require hook that works with any tool supporting preloading

## When to avoid
- you use Webpack - use tsconfig-paths-webpack-plugin instead
- your bundler already resolves path aliases at build time
- you don't use tsconfig/jsconfig path mapping

## Facets
- artifact type: library
- maturity: stable
- function: developer-tools, configuration-management, parser
- domain: developer-tools, web-development, backend, programming-languages
- platform: cli, cross-platform
- tags: typescript, tsconfig, module-resolution, path-mapping, runtime, ts-node, nodejs

## Member repositories
- jonaskello/tsconfig-paths (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.897575+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:43.283841+00:00, confidence not recorded.
  - readme: https://github.com/jonaskello/tsconfig-paths (fetched 2026-08-28T04:05:51.897575+00:00, sha 74be332cb6a8)
- Data as of 2026-08-30T08:39:29.467469+00:00.