Skip to content

ramajonnada/zyra-ui

Repository files navigation

Zyra UI

CI npm version License: MIT

A dark-mode-first Angular component library built with design tokens, signals, and zero-runtime theming.

Live Playground →


Features

  • Angular 21+ signals-first — every component uses input(), output(), signal(), computed()
  • Design-token theming — swap the entire look with one CSS variable file
  • Dark-mode first — designed in the dark, perfected in the light
  • Standalone components — no NgModules, just import what you need
  • Tree-shakeable — only ship what you use
  • WCAG 2.1 AA accessible — keyboard nav, focus rings, ARIA labels built in

Components

Component Selector Description
Button zyra-button Variants, sizes, loading, icons
Badge zyra-badge Status labels with dot indicator
Card zyra-card Content containers with slots
Input zyra-input Text input with validation states
Spinner zyra-spinner Loading indicator
Toast zyra-toast Notification toasts
Tooltip zyra-tooltip Hover tooltips with positioning
Avatar zyra-avatar Profile avatars with online indicator
Form Field zyra-form-field Label + input + hint wrapper

Installation

npm install zyra-ng-ui

Peer dependencies

npm install @fortawesome/angular-fontawesome @fortawesome/fontawesome-svg-core @fortawesome/free-solid-svg-icons

Import styles

In your styles.scss:

@import 'zyra-ng-ui/styles';

Quick Start

import { ZyraButton, ZyraBadge } from 'zyra-ng-ui';

@Component({
  imports: [ZyraButton, ZyraBadge],
  template: `
    <zyra-button variant="primary" (clicked)="onClick()">
      Get Started
    </zyra-button>

    <zyra-badge variant="success" [dot]="true">Online</zyra-badge>
  `
})
export class AppComponent {
  onClick() {}
}

Theming

All colors, spacing, and radii are CSS variables. Override them in your global styles:

:root {
  --zyr-accent: #your-brand-color;
  --zyr-radius-md: 8px;
}

Monorepo Structure

projects/
  zyra-ng-ui/     ← publishable Angular library (npm)
  zyra-ui/        ← marketing site + component playground

Contributing

See CONTRIBUTING.md for setup instructions and branch workflow.

Changelog

See CHANGELOG.md for version history.

License

MIT © Rama Jonnada

About

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors