justkey007/tsc-alias

Health v2 · maintenance only

Adoption not part of the score

1138 stars · 77 forks observed · 2026-09-03

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

tsc-alias is an npm CLI tool and library that rewrites TypeScript path aliases to relative import paths after tsc compilation. It runs as a post-build step so compiled JavaScript output has no runtime dependency on tsconfig path mappings.

Use cases

• replace tsconfig path aliases with relative paths after tsc build
• make compiled output work without runtime path registration
• resolve full import paths with .js extensions for ESM compatibility
• watch mode alias rewriting alongside tsc -w
• use path aliases referencing projects outside the tsconfig baseUrl
• programmatically rewrite alias paths via the replaceTscAliasPaths API

When to choose

• you use tsc to build and rely on tsconfig paths aliases
• you want compile-time alias resolution with no runtime dependencies
• you need ESM-compatible fully resolved import extensions in output

When to avoid

• you use a bundler like webpack, esbuild, or tsup that resolves aliases itself
• you prefer runtime path resolution via tsconfig-paths
• your project does not use TypeScript path aliases

Facets

cli-tool · maturity active

build-tool developer-tools developer-tools web-development compilers cli cross-platform typescript path-aliases tsc module-resolution post-compilation nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="justkey007/tsc-alias")