Expo: Introduction

kizunasync/expo supplies the platform ports a React Native app needs: the SQLite driver, the NetInfo connectivity signal, the AppState foreground signal, the file sandbox for attachments, and the native download half of the transfer port. The client itself is built with createSupabaseKizunaSync, and the hooks come from kizunasync/react.

Version#

kizunasync/expo 0.2.6-alpha.3 (Alpha). npm package kizunasync, import path kizunasync/expo; Expo SDK and React Native optional peers. See Installing.

What this reference covers#

• Initializing builds the client over the driver, and Open the SQLite driver is the one every app needs, because it also carries the network and foreground signals. Those two pages are the shortest path to a working native client.
• The rest of the surface covers the alternative op-sqlite driver and the Verify op-sqlite check a release runs on a device, the Connectivity and Foreground ports for an app that passes its own, the File store and Native download that attachments need, and the Rust engine selection on device.
• Every option the client takes is documented in the JavaScript tree, and the components that read the client are documented in the React tree.

What Supabase covers#

Concern	Use
Sign-in, sessions, and token refresh on React Native	startAutoRefresh and Auth sessions
Row Level Security policies	Write a policy for each operation
Realtime channels behind the wake-up doorbell	subscribe
Storage buckets, objects, and their policies	upload and Access control

Kizuna adds one thing to each row above. A foreground signal refreshes the session before the next run, so an attempt never runs on an expired access token. The server judges the policies when a queued write reaches it, not when the component renders. A Realtime message wakes a sync run instead of carrying data. Attachment bytes move through the transfer port that Media and attachments describes.

Related reference#

• Installing
• Initializing
• React: Introduction
• Vue: Introduction
• JavaScript: Introduction