Import aliases
postman-app uses TypeScript path aliases to make imports clean and refactoring-safe. Here is the complete reference.
| Alias | Resolves to | When to use |
|---|---|---|
@postman-app/<name> | Nx package via node_modules symlink | Always — the canonical import path for all Nx packages |
@postman-app-monolith/* | src/* | Temporary bridge during monolith migration — remove in decouple PR |
@@renderer/* | src/renderer/* | Legacy only — never use in new code |
@postman/* | External @postman npm packages | Third-party Postman packages (e.g. @postman/aether) |
Examples
// New code — always use @postman-app/*
import { WorkspaceStore } from '@postman-app/workspace-data';
import { Button } from '@postman-app/aether-components';
import { useTranslation } from '@postman-app/i18n-sdk';
// Mid-migration bridge — acceptable, but plan to remove
import { NavigationService } from '@postman-app-monolith/renderer/router/NavigationService';
// Legacy code only — do not use in Nx packages
import { something } from '@@renderer/collaboration/workspace/something';
Adding a new alias
Aliases are defined in tsconfig.base.json at the repo root. When you generate a new Nx package using the generator, the alias is added automatically. Do not add aliases manually.