OTAUpdatesProvider

The main context provider that enables OTA update functionality throughout your app.

Basic Usage

import { OTAUpdatesProvider } from '@ddedic/expo-fancy-ota-updates';
import versionData from './ota-version.json';

export default function App() {
  return (
    <OTAUpdatesProvider config={{ versionData }}>
      <YourApp />
    </OTAUpdatesProvider>
  );
}

Props

children

• Type: ReactNode
• Required: Yes

Your app content.

theme

• Type: Partial<OTATheme>
• Required: No
• Default: defaultTheme

Custom theme configuration. Merged with defaults.

<OTAUpdatesProvider
  theme={{
    colors: {
      primary: '#6366F1',
      background: '#0B0B0F',
    },
    borderRadius: 16,
  }}
>

See Theming Guide for details.

translations

• Type: Partial<OTATranslations>
• Required: No
• Default: defaultTranslations (English)

Custom translations. Merged with defaults.

<OTAUpdatesProvider
  translations={{
    banner: {
      updateAvailable: 'Neue Version verfügbar',
      updateButton: 'Aktualisieren',
    },
  }}
>

See i18n Guide for details.

config

• Type: OTAConfig
• Required: No

Provider behavior configuration.

<OTAUpdatesProvider
  config={{
    checkOnMount: true,
    checkOnForeground: true,
    autoDownload: false,
    autoReload: false,
    versionData: require('./ota-version.json'),
    debug: __DEV__,
  }}
>

Config Options

checkOnMount

• Type: boolean
• Default: true

Check for updates when the provider mounts.

checkOnForeground

• Type: boolean
• Default: true

Check for updates when the app comes to foreground.

autoDownload

• Type: boolean
• Default: false

Automatically download updates when available.

autoReload

• Type: boolean
• Default: false

Automatically reload the app after download completes.

WARNING

Use autoReload: true carefully. It will reload the app without user confirmation.

versionData

• Type: OTAVersionData
• Required: No

Version information from ota-version.json.

import versionData from './ota-version.json';

<OTAUpdatesProvider config={{ versionData }}>

debug

• Type: boolean
• Default: __DEV__

Enable debug logging.

Complete Example

import { OTAUpdatesProvider, UpdateBanner } from '@ddedic/expo-fancy-ota-updates';
import { useColorScheme } from 'react-native';
import versionData from './ota-version.json';

export default function App() {
  const colorScheme = useColorScheme();
  
  return (
    <OTAUpdatesProvider
      theme={{
        colors: {
          primary: colorScheme === 'dark' ? '#6366F1' : '#4F46E5',
          background: colorScheme === 'dark' ? '#0B0B0F' : '#FFFFFF',
        },
      }}
      config={{
        checkOnMount: true,
        checkOnForeground: true,
        versionData,
      }}
    >
      <UpdateBanner />
      <YourApp />
    </OTAUpdatesProvider>
  );
}

Next Steps

• UpdateBanner Component →
• useOTAUpdates Hook →
• Theming Guide →