Back to Next Js

Absolute Imports and Aliases

examples/with-absolute-imports/README.md

16.2.51.8 KB
Original Source

Absolute Imports and Aliases

This example shows how to configure Absolute imports and Module path aliases in tsconfig.json (or jsconfig.json for JavaScript projects). These options will allow absolute imports from . (the root directory), and allow you to create custom import aliases.

If you’re working on a large project, your relative import statements might suffer from ../../../ spaghetti:

tsx
import Button from "../../../components/button";

In such cases, we might want to setup absolute imports using the baseUrl option, for clearer and shorter imports:

tsx
import Button from "components/button";

Furthermore, TypeScript also supports the paths option, which allows you to configure custom module aliases. You can then use your alias like so:

tsx
import Button from "@/components/button";

Deploy your own

How to use

Execute create-next-app with npm, Yarn, or pnpm to bootstrap the example:

bash
npx create-next-app --example with-absolute-imports with-absolute-imports-app
bash
yarn create next-app --example with-absolute-imports with-absolute-imports-app
bash
pnpm create next-app --example with-absolute-imports with-absolute-imports-app

Deploy it to the cloud with Vercel (Documentation).