Investigate offline support with TanStack SQLite persistence and offline transactions

Open
#10 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
sqlite, supabase, typescript

Research direction

Start with the Supabase collection adapter, TanStack browser SQLite persistence, and the TanStack offline transactions example. Evaluate persisted collections and offline inserts, updates, and deletes, then produce a working example or explain why it is not possible; document Auth, RLS, Realtime, retry, conflict, session-expiry, and multi-tab limitations and recommend adapter follow-ups.

Written by the indexing model from the issue text.

Description

enhancement ready-for-agent

What to build

Investigate the best supported path for using the Supabase collection adapter in offline-capable TanStack DB apps. This should use TanStack browser SQLite persistence and the TanStack offline transactions example as reference points.

The investigation should determine which pieces compose cleanly with this adapter today, which pieces need adapter changes, and which behaviors are constrained by Supabase Auth, RLS, PostgREST, or Realtime. The goal is not necessarily to deliver complete offline sync in one pass, but to produce examples or a clear design conclusion that users and maintainers can trust.

The completed issue should show the current best path for persisted collection data and offline mutation behavior. It should also document known limitations around queued writes, retry behavior, conflict handling, auth/session expiry, Realtime gaps, and multi-tab behavior.

Acceptance criteria

  • Evaluate TanStack browser SQLite persistence with Supabase-backed collections.
  • Evaluate TanStack offline transaction patterns with Supabase inserts, updates, and deletes.
  • Produce a working example or document exactly why one is not currently possible.
  • Document limitations around Auth, RLS, Realtime, conflicts, retries, and multi-tab behavior.
  • Recommend follow-up adapter changes if needed.

Blocked by

None - can start immediately.

Dominant language
TypeScript
Stars
57
Forks
5
Avg merge
5d 22h
Merged PRs (30d)
7

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from supabase/tanstack-db

All issues in supabase/tanstack-db

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.