@neural-ui/native
v0.1.0-beta.7
Published
Signals-first native Angular components for iOS and Android.
Maintainers
Readme
Neural Native
Native Angular components for iOS and Android.
Neural Native brings the Neural visual language to Angular Native: 64 mobile component entries, Angular signals, typed APIs, shared themes and modular imports.
Public beta: 0.1.0-beta.7. APIs and framework compatibility may change before 1.0. Pin the version in your application lockfile and check compatibility before updating Angular Native.
Documentation
- Neural Native documentation and interactive examples.
- Angular Native official documentation.
- Angular Native getting started guide.
- Neural Native on npm.
Install
Start with the compatible Angular Native template:
npx create-expo-app@latest my-neural-app --template @ng-native/[email protected]
cd my-neural-app
npm install @neural-ui/native@betaIn an existing Angular Native 0.22.2 application, run only the last command. The beta is published under the npm beta tag; @beta is intentional. Applications on Angular Native 0.21.0 should keep Neural Native 0.1.0-beta.6. Applications on Angular Native 0.19.2 should keep Neural Native 0.1.0-beta.5. Applications on Angular Native 0.18.2 should keep Neural Native 0.1.0-beta.2 until they update the framework.
Compatibility
| Dependency | This beta | | --- | --- | | Angular Native packages | 0.22.2 | | Angular | 22.2.2 tested; peers >=22.2.0 <23 | | Expo / React Native | 57.0.27 / 0.86.3 tested application baseline | | Current framework template | Expo 58.0.16 / React Native 0.88.0: consumer tests and iOS/Android bundles verified | | react-native-svg | 15.15.4 | | TypeScript | 6.0.3 development baseline | | Node.js | 22.22.3 or 24.15+ development baseline |
Keep the @ng-native/* packages on the same compatible release. Preserve the runtime and Metro configuration generated by the framework template. Additional native modules require a compatible Expo Go runtime or a development build containing those modules.
Angular Native connects Angular to the native renderer. Application components use Angular templates and signals; they do not require React components or a WebView. See the framework setup guide.
Your first screen
Replace src/app/app.ts in the generated application. Keep the exported class name App: the generated entry point already mounts it.
import { Component, signal } from '@angular/core';
import { SafeAreaProvider, SafeAreaView, Text, View } from '@ng-native/components';
import { NeuThemeComponent } from '@neural-ui/native/theme';
import { NeuInputComponent } from '@neural-ui/native/input';
import { NeuButtonComponent } from '@neural-ui/native/button';
@Component({
selector: 'app-root',
imports: [
SafeAreaProvider, SafeAreaView, Text, View,
NeuThemeComponent, NeuInputComponent, NeuButtonComponent,
],
template: `
<safe-area-provider>
<neu-theme scheme="system">
<safe-area-view class="screen">
<view class="content">
<neu-input label="Full name" [(value)]="name" />
<neu-button label="Save profile" (pressed)="save()" />
<text class="feedback">{{ feedback() }}</text>
</view>
</safe-area-view>
</neu-theme>
</safe-area-provider>
`,
styles: `
:host, .screen { flex: 1; }
.content { padding: 24px; gap: 16px; }
.feedback { color: var(--neu-text); }
`,
})
export class App {
readonly name = signal('');
readonly feedback = signal('');
save(): void {
const name = this.name().trim();
this.feedback.set(name ? 'Saved: ' + name : 'Enter your name.');
}
}Run the application's generated npm start command, then open Android, iOS or a compatible Expo Go host. The example keeps its state in memory; connect your own service for persistence.
Components
Import only the controls used by each Angular component:
import { NeuButtonComponent } from '@neural-ui/native/button';
import { NeuModalComponent } from '@neural-ui/native/modal';
import { NeuGalleryComponent } from '@neural-ui/native/gallery';| Area | Components | | --- | --- | | Actions | Button, IconButton, Button Group, Toggle Button Group, Toolbar, Speed Dial | | Forms | Input, Textarea, Password, Input Mask, Input OTP, Input Tags, Inline Editor, Checkbox, Switch, Radio, Number Input, Slider, Rating, Form Field, Uploader | | Selection | Select, Autocomplete, Listbox, Cascade Select, Tree Select, Pick List, Calendar, Date Input, Filter Bar | | Navigation | Nav, Tabs, Stepper, Menu, Context Menu, Sidebar | | Surfaces | Card, Panel, Accordion, Divider, Modal, Bottom Sheet, Confirm Dialog, Popover | | Data and media | Data View, Virtual List, Tree, Timeline, Avatar, Avatar Group, Stats Card, Carousel, Gallery, Image Viewer | | Feedback | Alert, Toast, Chip, Badge, Spinner, Progress Bar, Meter Group, Skeleton, Empty State, Notification Center |
Theme and shared utilities have their own @neural-ui/native/theme and @neural-ui/native/foundation entries. See the component catalogue and native examples.
State and forms
The application owns editable data and actions:
[(value)]="name"connects a writable signal to a text control.[(checked)]="enabled"connects Checkbox or Switch.[disabled]="saving()"configures a control.(pressed)="save()"requests an application action.[(open)]="editing"controls a presentation.
Angular Signal Forms is optional. Import FormField from @angular/forms/signals and bind [formField] to a field in your form tree instead of maintaining a second value signal. Keep @angular/forms aligned with the application's Angular version.
Themes and customization
Place one neu-theme around the application. Descendant controls inherit it. scheme accepts system, light or dark; tokens accepts Partial<NeuTokens>. Add the following type import and property to your root component.
import type { NeuTokens } from '@neural-ui/native/foundation';
readonly brand = {
accent: '#3B5BDB',
onAccent: '#FFFFFF',
radius: 16,
} satisfies Partial<NeuTokens>;Bind that property with <neu-theme scheme="system" [tokens]="brand">. Use --neu-* variables in native styles to share the resolved palette and scale. A fixed token override applies in both light and dark modes: provide mode-specific values when your brand needs them.
Use projected content with controls such as Card, Modal and Bottom Sheet. Collection components expose typed customization APIs; check each component's public inputs before supplying a template.
Accessibility and localization
Optional haptic feedback is available from beta.5. Applications explicitly enable it with provideNeuHaptics(), can silence individual controls with [haptic]="false" and can change the preference at runtime. Install expo-haptics and rebuild the native app first. See the haptics guide.
Provide visible labels, useful validation messages and accessible names for icon actions. Localize the labels exposed by the component API; date controls also accept locale. Translate display labels while keeping option IDs and saved values stable.
Neural Form Field arranges projected content; connect the name, requirement and help to the projected native control itself. It is separate from Angular Signal Forms' FormField.
Check the complete application with VoiceOver/TalkBack, enlarged text, reduced motion, keyboard input and both orientations. Native controls and custom themes need verification in the application where they are used.
Development
npm ci
npm run build
npm run typecheck
npm run lint
npm test
npm run test:showcase
npm run verify:consumerverify:consumer installs the packed library in an isolated application, checks templates and interactions, and creates iOS and Android bundles. To explore the native catalogue, run npm run showcase and open it with a compatible native host.
Generated build, coverage and verification outputs are ignored by Git and are not included in the npm package.
Contributing
Keep changes focused and use the public native APIs in examples and tests. Add a regression test for behavior changes. Please include a small reproduction, framework version and affected platform when reporting an issue.
Credits
Built for Angular Native, created by Ashley Hunter. Angular Native's framework and community make native Angular applications possible.
Neural Native is maintained by Pedro Moreno Trujillo and shares its visual identity with the Neural UI ecosystem.
Español
Neural Native ofrece componentes Angular nativos para iOS y Android. Esta beta.7 se instala con npm install @neural-ui/native@beta sobre una aplicación Angular Native 0.22.2. Para Angular Native 0.21.0, conserva beta.6. Si tu aplicación utiliza Angular Native 0.19.2, conserva beta.5; para Angular Native 0.18.2, conserva Neural Native 0.1.0-beta.2 hasta actualizar el framework. Los controles utilizan signals, un tema compartido e imports modulares; tu aplicación conserva el estado y decide cómo guardar los datos. Desde beta.5 puedes activar la respuesta háptica opcional, silenciar controles concretos y cambiar esa preferencia durante la ejecución.
License
MIT © Pedro Moreno Trujillo. See LICENSE.
