ArtificialSense Labs

Get started with @artificialsenselabs/ui

Zero to a working component in under five minutes — install, load tokens, enable zoneless change detection, and render your first sense- control.

Walkthrough

Six steps

Copy the snippets into a fresh Angular 21.2+ or 22 standalone app. Components still in development stay in the monorepo until they graduate to the public barrel.

  1. Prerequisites

    Angular 21.2+ or 22 standalone application. ArtificialSense UI is built for zoneless change detection, OnPush, and SSR — match that shape for the smoothest integration.

  2. Install packages

    Add the component library, its design tokens, and the icon catalogue it peers on. Tokens define every `--sense-*` CSS custom property the components expect. The first public npm release is in preparation: until it lands, npm resolves these names to an empty 0.0.1 placeholder.

    npm install @artificialsenselabs/ui @artificialsenselabs/tokens @artificialsenselabs/icons
  3. Load design tokens globally

    Import tokens once in your global stylesheet so semantic colours, spacing, and typography are available to every component.

    @use '@artificialsenselabs/tokens' as tokens;
  4. Enable zoneless change detection (recommended)

    Register zoneless CD in `app.config.ts`. Components use signals — no `zone.js`, no `markForCheck()`.

    import { ApplicationConfig, provideZonelessChangeDetection } from '@angular/core';
    
    export const appConfig: ApplicationConfig = {
      providers: [
        provideZonelessChangeDetection(),
        // provideRouter(routes), provideClientHydration(), …
      ],
    };
  5. Import a component

    The public barrel exports the full `sense-` component set — form controls, overlays, navigation, data display, and feedback. Import standalone components into your own standalone component.

    import { ChangeDetectionStrategy, Component } from '@angular/core';
    import { SenseButtonComponent } from '@artificialsenselabs/ui';
    
    @Component({
      standalone: true,
      imports: [SenseButtonComponent],
      changeDetection: ChangeDetectionStrategy.OnPush,
      template: `<sense-button variant="filled">Save</sense-button>`,
    })
    export class ExampleComponent {}
  6. Run the app and verify

    Start your dev server, confirm the button renders with token-driven styles, and check the browser console for hydration or import errors. If styles look unstyled, tokens are not loaded globally.

    ng serve

Next

Go deeper

Narrative docs, source, and studio services once the first component is on screen.

  • Component docs

    API reference, usage examples, and accessibility notes for every exported component.

  • npm package

    The package page on public npm — versions, peer dependencies, and the MIT licence.

  • ArtificialSense Labs

    Packages, philosophy, and the principles behind them.

  • Architecture Review

    Fixed-scope senior audit when you are evaluating a production migration.