Air Money React UI Library

A comprehensive React UI library built with TypeScript, providing reusable components, hooks, and utilities for the Air Money application ecosystem.

📚 User Guide

For detailed usage instructions, component documentation, and examples, please refer to our User Guide (coming soon).

🛠️ Development

Prerequisites

• Node.js 18+
• Yarn 1.22.22+
• TypeScript 5.8+

Setup

1. Clone the repository
2. Install dependencies:

   yarn install

Available Scripts

• yarn dev - Start development server with hot reload
• yarn build - Build the library for production
• yarn check-types - Run TypeScript type checking
• yarn lint - Run ESLint and fix issues
• yarn preview - Preview the built library
• yarn watch:css - Watch and compile CSS changes
• yarn release - Build and publish to npm
• yarn version - Update version using changesets
• yarn bump - Create changeset and update version
• yarn changeset - Create a new changeset
• yarn push - Publish to yalc for local testing

Building

The library is built using Vite with the following configuration:

• Entry point: src/index.ts
• Output formats: ES modules and CommonJS
• TypeScript: Full type definitions generated
• CSS: Tailwind CSS with custom am- prefix
• External dependencies: React, React DOM, Controller SDK

Development Workflow

1. Make changes to components, hooks, or utilities
2. Run type checking: yarn check-types
3. Lint code: yarn lint
4. Test locally: yarn dev or yarn push for yalc testing
5. Build: yarn build
6. Create changeset: yarn changeset (for version changes)

Code Style

• ESLint: Configured with Air Money's custom config
• Prettier: Code formatting with custom config
• TypeScript: Strict mode enabled
• Import sorting: Automatic import organization

Publishing

1. Create a changeset: yarn changeset
2. Update version: yarn version
3. Build and publish: yarn release

Testing Locally

Use yalc to test the library in other projects:

# Publish to yalc
yarn push

# In your test project
yalc add @airmoney-degn/react-ui

Dependencies

• React 19.1.0+ - UI framework
• TypeScript 5.8+ - Type safety
• Tailwind CSS 3.4+ - Styling
• Radix UI - Accessible components
• Controller SDK 7.2+ - Device integration

🤝 Contributing

This library is maintained by the Air Money team. For issues and feature requests, please contact the development team.

📄 License

This project is proprietary and confidential. All rights reserved.

🔗 Related Packages

• @airmoney-degn/controller-sdk - Core SDK for Air Money devices
• @airmoney-degn/eslint-config - ESLint configuration
• @airmoney-degn/prettier-config - Prettier configuration

📞 Support

For technical support and questions, please contact the Air Money development team.