0Pricing
TypeScript Academy · Lesson

Path Aliases and baseUrl

Configure paths for cleaner imports.

Path Aliases and baseUrl is a free TypeScript Academy lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the TypeScript Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Welcome

Path aliases clean up deep relative import paths and are configured in tsconfig.

The Import Path Problem

Deep relative paths like ../../../../utils are brittle and hard to read.
import { logger } from '../../../../utils/logger';
import { User } from '../../../models/user';

baseUrl

baseUrl sets the root for resolving non-relative imports.
{ "compilerOptions": { "baseUrl": "./src" } }
// Now you can import from 'utils/logger' directly

paths Aliases

paths maps import prefixes to directory locations.
{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"], "@utils/*": ["src/utils/*"] } } }

Using Path Aliases

Import using the @ prefix instead of relative paths.
import { logger } from '@/utils/logger';
import { User } from '@/models/user';

Bundler Configuration

Bundlers (Vite, webpack) need to be configured separately to resolve path aliases.
// vite.config.ts
import { resolve } from 'path';
export default { resolve: { alias: { '@': resolve(__dirname, 'src') } } };

tsconfig-paths for Node

Use tsconfig-paths with ts-node to resolve path aliases in Node.js.
npm install tsconfig-paths
// tsconfig.json: "ts-node": { "require": ["tsconfig-paths/register"] }

Multiple Path Mappings

Define aliases for different parts of your project.
{ "paths": { "@models/*": ["src/models/*"], "@services/*": ["src/services/*"], "@utils/*": ["src/utils/*"] } }

Wildcard Paths

The * wildcard matches any sub-path.
// '@/*': ['src/*'] maps '@/foo/bar' to 'src/foo/bar'

Exact Path Aliases

Alias a specific module to a specific file.
{ "paths": { "@config": ["src/config/index.ts"], "@types": ["src/types/index.ts"] } }

Path Aliases vs Barrel Files

Use both together: path aliases reduce depth, barrel files aggregate exports.

Quick Check

What does the `baseUrl` option in tsconfig set?

Recap

Path Aliases and baseUrl: mastered the key concepts and patterns.

Frequently asked questions

Is the “Path Aliases and baseUrl” lesson free?

Yes — the full text of “Path Aliases and baseUrl” is free to read here on the web, and the TypeScript Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the TypeScript Academy course, upgrade to CoddyKit PRO.

What will I learn in “Path Aliases and baseUrl”?

Configure paths for cleaner imports. You practise TypeScript Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start TypeScript Academy?

No prior experience is required. TypeScript Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Path Aliases and baseUrl” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this TypeScript Academy lesson?

Yes. Every TypeScript Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. The strict Flag and What It Enables
  2. Module and Target Configuration
  3. Path Aliases and baseUrl
  4. Incremental Builds and Declaration Files
← Back to TypeScript Academy