AMS Components & UI

Custom reusable React Native / Expo UI components and navigation templates for building apps faster.

📦 Installation

# Install the package
npm install @animesh08/ams-components
# or using yarn
yarn add @animesh08/ams-components

Note: This only installs the package itself. Optional dependencies (e.g., react-navigation) will be installed only if required by selected components.

⚡ Usage

After installing, run the CLI to copy components into your project:

npx ams-ui

You’ll be prompted to select components, navigation, or utilities to add.

The CLI can also optionally install any required peer dependencies automatically for selected components.

Example

import React from "react";
import { View } from "react-native";
import { AmsButton, DrawerNavigator, BottomNav } from "./components"; // copied files

export default function App() {
  return (
    <View style={{ flex: 1 }}>
      <AmsButton title="Click Me" />
      <DrawerNavigator />
    </View>
  );
}

🧩 Available UI Components

Components

• AmsButton – Custom styled button
• AmsCard – Card UI component
• QRScanner – QR code scanner
• AlertMessage – Alert UI Component
• RNInput – Custom Text input UI
• Captcha – Custom Captcha input UI component
• DialogComponent – Custom Dialog UI component
• ImageUpload – Custom ImagePicker UI component

Navigation Components

• BottomNav – Bottom tab navigation
• DrawerNavigator – Drawer navigation

Utility Components

• GenerateCaptcha – Utility for captchas

Page Components

• LoginComponent – a page component for Login

⚙ Requirements

• react-native >= 0.73
• react >= 18.0.0
• expo (if using Expo)
• Optional dependencies (install via CLI if using navigation components):
  • @react-navigation/drawer
  • @react-navigation/bottom-tabs
  • @react-navigation/native
  • expo-image-picker

The CLI will detect and prompt to install required packages automatically if needed.

💡 CLI Options

• Select components, navigation, or utils to copy into your project
• Supports multiple folder structure: Components/, navigation/, utils/, Services/, PageComponents/
• Automatically detects missing peer dependencies and optionally installs them

🔖 License

MIT © Animesh Mitra