bun-types/docs/guides/runtime/tsconfig-paths.mdx

Type definitions and documentation for Bun, an incredibly fast JavaScript runtime

---
title: Re-map import paths
sidebarTitle: Re-map import paths
mode: center
---

Bun reads the `paths` field in your `tsconfig.json` to re-write import paths. This is useful for aliasing package names or avoiding long relative paths.

```json tsconfig.json icon="file-json"
{
  "compilerOptions": {
    "paths": {
      "my-custom-name": ["zod"],
      "@components/*": ["./src/components/*"]
    }
  }
}
```

---

With the above `tsconfig.json`, the following imports will be re-written:

```ts tsconfig.ts icon="/icons/typescript.svg"
import { z } from "my-custom-name"; // imports from "zod"
import { Button } from "@components/Button"; // imports from "./src/components/Button"
```

---

See [Docs > Runtime > TypeScript](/docs/runtime/typescript) for more information on using TypeScript with Bun.