backgroundTasks

// kuito.config.ts
import type { KuitoConfig } from 'kuito/config';

export default {
  name: 'Reel',
  ios: { bundleIdentifier: 'com.example.reel' },
  android: { applicationId: 'com.example.reel' },
  backgroundTasks: ['sync'],
} satisfies KuitoConfig;

import { Button, Text, VStack, backgroundTasks, storage, task } from 'kuito';

// At module scope: a background launch runs the app's modules, not its UI.
backgroundTasks.define('sync', async ({ deadline }) => {
  const remaining = deadline - Date.now() - 1000;
  if (remaining <= 0) return;
  const response = await fetch('https://example.com/feed', {
    signal: AbortSignal.timeout(remaining),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);

  await storage.set('feed', await response.text());
});

export default function App() {
  const enable = task(async () => {
    if ((await backgroundTasks.status()) !== 'available')
      throw new Error('Background refresh is unavailable');
    await backgroundTasks.schedule('sync', { minimumInterval: 60, requiresNetwork: true });
  });
  return (
    <VStack>
      <Button disabled={enable.running.value} onPress={() => void enable.run().catch(() => {})}>
        Enable background sync
      </Button>
      <Text>{enable.error.value ? String(enable.error.value) : ''}</Text>
    </VStack>
  );
}