Name: Offline First
Author: JAFAR564

Philosophy

The Construct must work fully offline. Every feature must:

Work without Supabase — use localDB (localforage/IndexedDB)
Work without AI proxy — use fallback narratives
Gracefully degrade — never show errors for missing network

localforage Setup

The app uses localforage (IndexedDB wrapper). See src/services/localDB.ts.

import localforage from 'localforage';

// Configure
localforage.config({
  name: 'the-construct',
  storeName: 'game_data',
});

// Basic operations
await localforage.setItem('user', userData);
const user = await localforage.getItem<User>('user');
await localforage.removeItem('user');

Data Persistence Pattern

Every Zustand store should persist to localforage:

Philosophy

The Construct must work fully offline. Every feature must:

Work without Supabase — use localDB (localforage/IndexedDB)
Work without AI proxy — use fallback narratives
Gracefully degrade — never show errors for missing network

localforage Setup

The app uses localforage (IndexedDB wrapper). See src/services/localDB.ts.

import localforage from 'localforage';

// Configure
localforage.config({
  name: 'the-construct',
  storeName: 'game_data',
});

// Basic operations
await localforage.setItem('user', userData);
const user = await localforage.getItem<User>('user');
await localforage.removeItem('user');

Data Persistence Pattern

Every Zustand store should persist to localforage:

Mode	VITE_SUPABASE_URL	VITE_API_ENDPOINT	Behavior
Offline	empty	empty	localDB + fallback content
Supabase	set	empty	Postgres + fallback content
Full	set	set	Postgres + AI narrative

Offline First

Philosophy

localforage Setup

Data Persistence Pattern

Offline First

Philosophy

localforage Setup

Data Persistence Pattern

Three Environment Modes

Testing Offline Mode

Export/Import

Vector Index Tuning

Azure Resource Manager Redis Dotnet

Redis Expert

Elasticsearch

Cache Expert

Abp Mongodb