Install

@awdlab/jig and its theme package are installed together:

pnpm add @awdlab/jig @awdlab/jig-themes

Both are separate packages — the controls hold behavior, the themes hold styling. Installing only @awdlab/jig will leave every control unstyled and throw at runtime if no theme preset is provided.

Peer dependencies

The library targets Angular 22+ and expects these peers in your app:

• @angular/common, @angular/compiler, @angular/core, @angular/forms, @angular/platform-browser, @angular/router
• @floating-ui/dom — positioning for overlays (tooltip, popover, select…)
• @ngneers/signal-translate, rxjs

@iconify/icons-tabler is an optional peer. It's only pulled in by the withDefaultIcons() feature — if you supply your own icon set with withCustomIcons(), you don't need it.

Most likely you have to add these to your app and are already using the others:

pnpm add @floating-ui/dom @ngneers/signal-translate @iconify/icons-tabler

No Tailwind, no CSS import. Control styling is generated and injected at runtime by the theme engine — there is no stylesheet to import and Tailwind is not required to consume the library.

Register the provider

Add provideJigControls to your application config, passing a theme preset and any optional features you want:

import { ApplicationConfig } from '@angular/core';
import { provideJigControls, withAutoColorScheme } from '@awdlab/jig/api/ng';
import { withDefaultIcons } from '@awdlab/jig/default-icons';
import { withToasts } from '@awdlab/jig/toast';
import { withSnackbars } from '@awdlab/jig/snackbar';
import { nova } from '@awdlab/jig-themes/nova';

export const appConfig: ApplicationConfig = {
  providers: [
    provideJigControls(
      { theme: { preset: nova } }, // the preset is a Theme object, not a string
      withDefaultIcons(), // register the built-in Tabler icon set
      withAutoColorScheme(), // enable automatic light/dark mode
      withToasts(),
      withSnackbars()
    ),
  ],
};

Only the config object is required — every with*() feature is opt-in. Drop the ones you don't need.

Next steps

• Usage — import and render a control.
• Theming › Dark Mode — the details behind withAutoColorScheme().