location

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

export default {
  name: 'Screenings',
  ios: { bundleIdentifier: 'com.example.screenings' },
  android: { applicationId: 'com.example.screenings' },
  permissions: { location: 'Find screenings near you.' },
} satisfies KuitoConfig;

import { Text, location, permissions } from 'kuito';

const { status } = await permissions.request('location');

if (status === 'granted') {
  const here = await location.current({ accuracy: 'high' });
  const [place] = await location.reverseGeocode(here.coords);
}

function Here() {
  // Locates while Here is mounted; the fixes land in location.position.
  location.watch({ distanceInterval: 20 });

  return <Text>{`${location.position.value?.coords.latitude ?? '…'}`}</Text>;
}

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

export default {
  name: 'Runs',
  ios: { bundleIdentifier: 'com.example.runs' },
  android: { applicationId: 'com.example.runs' },
  permissions: {
    location: 'Map your runs.',
    locationAlways: 'Record your runs with the screen off.',
  },
} satisfies KuitoConfig;

import { location, permissions, storage } from 'kuito';

// At module scope: a background launch runs the app's modules, not its UI.
location.defineUpdates('run', async ({ locations }) => {
  const track: unknown[] = JSON.parse((await storage.get('track')) ?? '[]');

  await storage.set('track', JSON.stringify([...track, ...locations.map((fix) => fix.coords)]));
});

async function startRun() {
  const { status } = await permissions.request('locationAlways');

  if (status === 'granted')
    await location.startUpdates('run', {
      accuracy: 'high',
      distanceInterval: 10,
      notification: { title: 'Recording your run' },
    });
}