Skip to main content
Neural Nativev0.1.0-beta.1Documentation

Import

component.ts
import { NeuBadgeComponent } from '@neural-ui/native/badge';

Examples

Import ExampleComponent into its parent and place <app-example /> inside your application’s root neu-theme. The preview supplies the device frame and safe areas; use the root setup from Installation in your app.

Status label

Use badges for concise status and category metadata. A separate action changes the review state; the badges themselves remain informational.

View and copy the complete example
status.component.ts
import { Component, signal } from '@angular/core';
import { NeuButtonComponent } from '@neural-ui/native/button';
import { NeuCardComponent } from '@neural-ui/native/card';
import { NeuBadgeComponent } from '@neural-ui/native/badge';
import { View, Text, ScrollView } from '@ng-native/components';

@Component({
  selector: 'app-example',
  imports: [NeuButtonComponent, NeuCardComponent, NeuBadgeComponent, View, Text, ScrollView],
  template: `
    <scroll-view class="product-scroll" keyboardShouldPersistTaps="handled" [showsVerticalScrollIndicator]="true"><view class="product-stack"><view class="product-section"><text class="product-title" accessibilityRole="header">Status at a glance</text><text class="product-caption">A few words that keep the team aligned</text></view>
    <neu-card title="Mobile launch" description="Product workspace" variant="outlined"><view class="product-section"><view class="product-actions"><neu-badge [label]="ready() ? 'Ready to launch' : 'In progress'" [tone]="ready() ? 'success' : 'info'" /><neu-badge label="Mobile" tone="neutral" /></view>
    <text>Polish the welcome flow and prepare the final release notes.</text>
    <view class="product-actions"><neu-button [label]="ready() ? 'Reopen review' : 'Mark review complete'" size="sm" variant="text" (pressed)="ready.set(!ready())" /></view></view></neu-card></view></scroll-view>
  `,
  styles: `
.actions { gap: 12px; align-items: flex-start; } text { color: var(--neu-text, #172033); font-size: 16px; }

:host { flex: 1; flex-shrink: 1; min-height: 0; }
.product-scroll { flex: 1; flex-shrink: 1; height: 0px; min-height: 0; }
.product-stack { gap: 24px; padding-bottom: 20px; }
.product-section { gap: 12px; }
.product-row { flex-direction: row; align-items: center; gap: 12px; }
.product-copy { flex: 1; min-width: 0; gap: 4px; }
.product-title { color: var(--neu-text, #172033); font-size: 24px; line-height: 30px; font-weight: 600; }
.product-heading { color: var(--neu-text, #172033); font-size: 17px; line-height: 23px; font-weight: 600; }
.product-caption { color: var(--neu-muted, #596477); font-size: 14px; line-height: 20px; }
.product-actions { flex-direction: row; flex-wrap: wrap; align-items: center; gap: 8px; }
.product-surface { gap: 16px; padding: 16px; border-radius: 16px; background-color: var(--neu-surface, #ffffff); border-width: 1px; border-color: var(--neu-border, #a5afbf); }

  `,
})
export class ExampleComponent {
  readonly ready = signal(false);
}

Semantic colors

Compare six status colors using the theme palette.

View and copy the complete example
semantic-colors.component.ts
import { Component } from '@angular/core';
import { NeuBadgeComponent } from '@neural-ui/native/badge';
import { View, ScrollView } from '@ng-native/components';

@Component({
  selector: 'app-example',
  imports: [NeuBadgeComponent, View, ScrollView],
  template: `
    <scroll-view class="usage-scroll" keyboardShouldPersistTaps="handled"><view class="usage-stack">
    <view class="usage-row"><neu-badge label="brand" tone="brand" />
    <neu-badge label="neutral" tone="neutral" />
    <neu-badge label="success" tone="success" />
    <neu-badge label="info" tone="info" />
    <neu-badge label="warning" tone="warning" />
    <neu-badge label="danger" tone="danger" /></view>
    </view></scroll-view>
  `,
  styles: `
.actions { gap: 12px; align-items: flex-start; } text { color: var(--neu-text, #172033); font-size: 16px; }

.usage-scroll { flex: 1; }
.usage-stack { gap: 20px; padding-bottom: 20px; }
.usage-section { gap: 12px; }
.usage-heading { color: var(--neu-text, #172033); font-size: 16px; font-weight: 600; }
.usage-caption { color: var(--neu-muted, #64748b); font-size: 14px; }
.usage-row { flex-direction: row; flex-wrap: wrap; gap: 12px; align-items: center; }
.usage-actions { flex-direction: row; flex-wrap: wrap; gap: 8px; align-items: center; }


  `,
})
export class ExampleComponent {

}
Interactive playground

Change the settings and try the result.

Device captures shown in English.

Badge · android · native capture
AndroidNative screenshot
Badge · ios · native capture
iOSNative screenshot

API reference

Inputs

NameTypeDefaultBindingDescription
labelstringRequiredInputHuman-readable name for the control, action or group.
toneNeuTone'neutral'InputSemantic color applied to both the label and a lightly tinted background: neutral, brand, success, info, warning or danger. Colors update with the containing NeuTheme and its token overrides. The accent value remains a compatibility alias for brand.

Models

This component declares no two-way models.

Outputs

This component declares no public outputs.

Types and data interfaces

Use the imports in your application. The definitions below are provided for reference.

NeuTone

NeuTone.ts
import type { NeuTone } from '@neural-ui/native/foundation';

// Public definition for reference only. Import this type; do not redeclare it.
export type NeuTone = 'neutral' | 'brand' | 'accent' | 'success' | 'info' | 'warning' | 'danger';