@tcbs/react-native-mazic-ui

A customizable React Native UI component library.

Installation

npm install @tcbs/react-native-mazic-ui @tcbs/react-native-exception-handler

yarn add @tcbs/react-native-mazic-ui @tcbs/react-native-exception-handler

Error Handling: AppErrorBoundary

AppErrorBoundary is a React error boundary component for catching and displaying errors in your app. It supports custom fallback UIs for both development and production modes.

Quick Usage

import { AppErrorBoundary } from '@tcbs/react-native-mazic-ui';

<AppErrorBoundary>
  <YourApp/>
</AppErrorBoundary>

You can also provide custom fallback UIs for dev and prod:

<AppErrorBoundary
  fallbackDev={<Text>DEV: Something went wrong.</Text>}
  fallbackProd={<Text>PROD: Please try again later.</Text>}
>
  <YourApp/>
</AppErrorBoundary>

For full details and advanced usage, see docs.

Theme Setup Example

import { useTcbsColorStore } from '@tcbs/react-native-mazic-ui';

const { setTcbsColor } = useTcbsColorStore();

React.useEffect(() => {
  setTcbsColor({
    light: {
      btnColor: '#007AFF',
      btnBorderColor: '#007AFF',
      btnIconColor: '#16a62bff',
      themeColor: '#007AFF',
      btnTextColor: '#FFFFFF',
    },
    dark: {
      btnColor: '#222222',
      btnBorderColor: '#222222',
      btnIconColor: '#FFFFFF',
      themeColor: '#222222',
      btnTextColor: '#FFFFFF',
    },
  });
}, []);

Usage

import { Button } from '@tcbs/react-native-mazic-ui';

<Button title="Hello" onPress={() => {}} />

TcbsButton Component Usage

Basic Usage

import { TcbsButton } from '@tcbs/react-native-mazic-ui';

<TcbsButton
  title="Submit"
  onPress={() => console.log('Pressed')}
/>

Size Variations

<TcbsButton title="Large" size="large" onPress={...} />
<TcbsButton title="Medium" size="medium" onPress={...} />
<TcbsButton title="Small" size="small" onPress={...} />

Variant Styles

You can choose from three variants:

• primary: Filled button with main color
• secondary: Outlined button with border
• no_border: Button with no border and matches screen background

<View>
  <TcbsButton
    title="TCBS Button"
    variant="primary"
    onPress={() => console.log('TCBS Button Pressed')}
    iconName="heart"
    iconPosition="left"
  />
</View>
<View>
  <TcbsButton
    title="TCBS Button"
    variant="secondary"
    onPress={() => console.log('TCBS Button Pressed')}
    iconName="star"
    iconPosition="right"
  />
</View>
<View>
  <TcbsButton
    title="TCBS Button"
    variant="no_border"
    onPress={() => console.log('TCBS Button Pressed')}
    iconName="home"
    iconPosition="left"
  />
</View>

Size Options

You can choose from three sizes:

• large: Large button (default)
• medium: Medium button
• small: Small button

<TcbsButton title="Large" size="large" onPress={...} />
<TcbsButton title="Medium" size="medium" onPress={...} />
<TcbsButton title="Small" size="small" onPress={...} />

Supported Icon Groups

You can use the following icon groups for the iconGroup prop:

• AntDesign
• Feather
• FontAwesome
• Foundation
• Ionicons
• MaterialDesignIcons
• Octicons
• Lucide (if available in your project)

Example usage:

<TcbsButton
  title="AntDesign"
  iconName="check"
  iconGroup="AntDesign"
  iconPosition="left"
  onPress={...}
/>

<TcbsButton
  title="AntDesign"
  iconName="check"
  iconGroup="AntDesign"
  iconPosition="left"
  onPress={...}
/>

<TcbsButton
  title="Feather"
  iconName="arrow-right"
  iconGroup="Feather"
  iconPosition="right"
  onPress={...}
/>

<TcbsButton
  title="Top Icon"
  iconName="star"
  iconGroup="FontAwesome"
  iconPosition="top"
  onPress={...}
/>

Custom Colors and Styles

<TcbsButton
  title="Custom"
  style={{ backgroundColor: '#222' }}
  textStyle={{ color: '#FFD700' }}
  onPress={...}
/>

Accessibility

<TcbsButton
  title="Accessible"
  accessibilityLabel="Submit button"
  accessibilityHint="Submits the form"
  accessibilityRole="button"
  onPress={...}
/>

Disabled State

<TcbsButton
  title="Disabled"
  disabled
  onPress={...}
/>

See the exported TcbsButtonProps type for all available options.

License

MIT

Copyright (c) TechCraft By Subrata