# jamesisaac/react-native-background-task

Periodic background tasks for React Native apps, cross-platform (iOS and Android), which run even when the app is closed.

Repository: https://github.com/jamesisaac/react-native-background-task
Canonical: https://ross.abutalabs.com/products/react-native-background-task
Language: Java
License: MIT
License Family: permissive
Topics: react-native, background-jobs, fetch, android, ios, offline, sync
Last push: 2023-04-28T16:55:28+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3484, "days_push": 1223, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1114, forks 110 (observed 2026-08-28T04:03:38.189937+00:00)

## What it is
A React Native library for scheduling a single periodic background task that runs on iOS and Android even when the app is closed, no more frequently than every 15 minutes. It wraps Android Headless JS natively and iOS react-native-background-fetch behind a unified API, ideal for background data sync.

## Use cases
- run periodic background sync in a react native app
- sync data offline when app is closed
- schedule background jobs every 15 minutes on ios and android
- fetch data in background for offline support
- execute headless tasks in react native

## When to choose
- you need a single cross-platform periodic background task in React Native
- you want offline data sync that runs even when the app is closed
- you prefer one unified API over per-platform background libraries

## When to avoid
- you need multiple background tasks or fine-grained per-platform control
- you need tasks running more frequently than every 15 minutes
- your task requires UI work
- you are not building a React Native app

## Facets
- artifact type: library
- maturity: maintenance
- function: scheduling, workflow-automation
- domain: mobile-development
- platform: -
- tags: react-native, background-tasks, background-sync, offline-support, headless-js, background-fetch, automation, android, ios, mobile, javascript

## Member repositories
- jamesisaac/react-native-background-task (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:38.189937+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:42:31.399838+00:00, confidence not recorded.
  - readme: https://github.com/jamesisaac/react-native-background-task (fetched 2026-08-28T04:03:38.189937+00:00, sha 4f1427067d2d)
- Data as of 2026-08-30T08:39:29.467469+00:00.