ngx-phonenumbers

Directive and service to handle phone numbers with Google libphonenumber library


Keywords
angular, angular17, angular18, angular19, ui, input, phonenumber, typescript, directive, angularx, tailwindcss, ui-components
License
MIT
Install
npm install ngx-phonenumbers@4.1.3

Documentation

Angular Tailwind UI

A collection of easy-to-use Angular components, directives, and services built with Angular 19 and TailwindCSS 3. This library provides a set of modern, accessible, and customizable UI components that follow best practices and integrate seamlessly with your Angular applications.

โœจ Features

  • ๐ŸŽจ Modern Design: Built with TailwindCSS 3 for beautiful, responsive components
  • ๐Ÿš€ Angular 19 Ready: Fully compatible with the latest Angular version
  • โ™ฟ Accessibility First: All components follow WCAG guidelines
  • ๐ŸŒ™ Dark Mode Support: Built-in dark mode support for all components
  • ๐Ÿ“ฑ Responsive: Mobile-first approach with desktop optimizations
  • ๐ŸŽฏ Type-Safe: Full TypeScript support with comprehensive type definitions
  • ๐Ÿ”ง Customizable: Easy to customize with TailwindCSS classes
  • โšก Performance: Optimized for fast loading and smooth interactions
  • ๐Ÿ“ฆ Modular: Install only what you need
  • ๐Ÿ› ๏ธ Developer Experience: Built with developer productivity in mind

๐Ÿ“ฆ Packages

A responsive bottom sheet modal that adapts to screen size:

  • ๐Ÿ“ฑ Displays as bottom sheet on mobile
  • ๐Ÿ’ป Shows as modal dialog on desktop
  • ๐Ÿ”„ Smooth animations and transitions
  • ๐ŸŽจ Customizable styling with TailwindCSS
npm install @ngx-tailwind-ui/bottom-sheet-modal

Bottom Sheet Modal Demo

A flexible toast notification system:

  • ๐Ÿ“ Multiple types (info, success, warning, error)
  • โฑ๏ธ Configurable duration
  • ๐ŸŽจ Visual feedback with icons
  • ๐Ÿ”„ Progress bar support
  • ๐ŸŽฏ Dismissible notifications
npm install @ngx-tailwind-ui/toast

A comprehensive phone number handling solution:

  • ๐Ÿ” Validation using Google's libphonenumber
  • ๐ŸŒ Automatic country code detection
  • ๐Ÿ“ฑ Formatting to international/national format
  • ๐Ÿ”„ Two-way binding support
  • โ™ฟ Accessibility features
npm install @ngx-tailwind-ui/phonenumbers

๐ŸŽฎ Demo

View the live demo to see all components in action.

๐Ÿ› ๏ธ Prerequisites

  • Angular 17+ project
  • TailwindCSS 3
  • And package specific ones

๐Ÿš€ Quick Start

  1. Install the package(s) you need:
npm install @ngx-tailwind-ui/bottom-sheet-modal @ngx-tailwind-ui/toast @ngx-tailwind-ui/phonenumbers
  1. Import the components in your Angular application:
import { TauiBottomSheetModalComponent } from "@ngx-tailwind-ui/bottom-sheet-modal";
import { TauiToastComponent } from "@ngx-tailwind-ui/toast";
import { TauiPhonenumbersDirective } from "@ngx-tailwind-ui/phonenumbers";
  1. Add TailwindCSS to your project if not already installed:
npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init
  1. Configure your tailwind.config.js:
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,ts}", "./node_modules/@ngx-tailwind-ui/**/*.{html,ts,js,mjs}"],
  theme: {
    extend: {},
  },
  plugins: [],
};

๐ŸŒ Browser Support

All components are tested and supported on:

  • Chrome (latest)
  • Safari (latest)
  • Edge (latest)

โšก Performance Considerations

  • Change Detection: Optimized to minimize change detection cycles
  • Lazy Loading: Supports lazy loading for better initial load performance
  • Bundle Size: Minimal impact on bundle size
  • Memory Usage: Efficient memory management

๐Ÿค Contributing

We welcome contributions!

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.