@umituz/react-native-loading

Loading states and animations for React Native apps with breathing animations, skeleton loaders, and state management hooks.

Installation

npm install @umituz/react-native-loading

Peer Dependencies

• react >= 18.2.0
• react-native >= 0.74.0
• @umituz/react-native-design-system >= 1.5.0

Features

• ✅ Breathing animation loading state (meditation-inspired)
• ✅ Skeleton loaders with shimmer effect
• ✅ Loading state management hooks
• ✅ App-specific emoji presets
• ✅ Configurable sizes and patterns

Usage

Basic Loading State

import { LoadingState, useLoading } from '@umituz/react-native-loading';

const MyScreen = () => {
  const { isLoading, startLoading, stopLoading } = useLoading();

  return (
    <View>
      {isLoading ? (
        <LoadingState message="Loading..." />
      ) : (
        <Content />
      )}
    </View>
  );
};

Skeleton Loader

import { SkeletonLoader, useLoading } from '@umituz/react-native-loading';

const ListScreen = () => {
  const { isLoading } = useLoading();

  return (
    <View>
      {isLoading ? (
        <SkeletonLoader pattern="list" count={5} />
      ) : (
        <FlatList data={data} />
      )}
    </View>
  );
};

With Async Wrapper

import { LoadingState, useLoading } from '@umituz/react-native-loading';

const DataScreen = () => {
  const { isLoading, loadingMessage, withLoading } = useLoading();

  const loadData = () => withLoading(
    fetchData(),
    'Loading data...'
  );

  return (
    <View>
      {isLoading && <LoadingState message={loadingMessage} />}
      <Button onPress={loadData}>Load</Button>
    </View>
  );
};

API

Components

• LoadingState: Main loading component with breathing animation
• SkeletonLoader: Skeleton loader with shimmer effect

Hooks

• useLoading(): Main loading state management hook
• useSimpleLoading(): Simplified loading hook

Utilities

• LOADING_EMOJIS: App-specific emoji presets
• SIZE_CONFIGS: Size configuration presets
• SKELETON_PATTERNS: Skeleton loader patterns
• LoadingUtils: Utility functions for loading states

License

MIT