Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { atom } from 'jotai';
import { atomWithStorage } from 'jotai/utils';
import type { SyncStorage } from 'jotai/vanilla/utils/atomWithStorage';
/**
* Create a simple atom with localStorage persistence
* Uses Jotai's atomWithStorage with getOnInit for proper SSR support
*
* @param key - localStorage key
* @param defaultValue - default value if no saved value exists
* @returns Jotai atom with localStorage persistence
*/
export function createStorageAtom<T>(key: string, defaultValue: T) {
return atomWithStorage<T>(key, defaultValue, undefined, {
getOnInit: true,
});
}
/**
* Create an atom with localStorage persistence and side effects
* Useful when you need to apply changes to the DOM or trigger other actions
*
* @param key - localStorage key
* @param defaultValue - default value if no saved value exists
* @param onWrite - callback function to run when the value changes
* @returns Jotai atom with localStorage persistence and side effects
*/
export function createStorageAtomWithEffect<T>(
key: string,
defaultValue: T,
onWrite: (value: T) => void,
) {
const baseAtom = createStorageAtom(key, defaultValue);
return atom(
(get) => get(baseAtom),
(get, set, newValue: T) => {
set(baseAtom, newValue);
if (typeof window !== 'undefined') {
onWrite(newValue);
}
},
);
}
/**
* Create a SyncStorage adapter that reads/writes to localStorage but does NOT
* subscribe to browser `storage` events. This prevents cross-tab synchronization
* for atoms where each tab should maintain independent state.
*
* Use this for atoms that represent per-tab working state (e.g., favorites toggle,
* MCP server selections) rather than user preferences.
*/
export function createTabIsolatedStorage<Value>(): SyncStorage<Value> {
return {
getItem(key: string, initialValue: Value): Value {
if (typeof window === 'undefined') {
return initialValue;
}
try {
const stored = localStorage.getItem(key);
if (stored === null) {
return initialValue;
}
return JSON.parse(stored) as Value;
} catch {
return initialValue;
}
},
setItem(key: string, newValue: Value): void {
if (typeof window === 'undefined') {
return;
}
try {
localStorage.setItem(key, JSON.stringify(newValue));
} catch {
// quota exceeded or other write error — silently ignore
}
},
removeItem(key: string): void {
if (typeof window === 'undefined') {
return;
}
try {
localStorage.removeItem(key);
} catch {
// silently ignore
}
},
// subscribe intentionally omitted — prevents cross-tab sync via storage events
};
}
/**
* Create an atom with localStorage persistence that does NOT sync across tabs.
* Parallels `createStorageAtom` but uses tab-isolated storage.
*
* @param key - localStorage key
* @param defaultValue - default value if no saved value exists
* @returns Jotai atom with localStorage persistence, isolated per tab
*/
export function createTabIsolatedAtom<T>(key: string, defaultValue: T) {
return atomWithStorage<T>(key, defaultValue, createTabIsolatedStorage<T>(), {
getOnInit: true,
});
}
/**
* Initialize a value from localStorage and optionally apply it
* Useful for applying saved values on app startup (e.g., theme, fontSize)
*
* @param key - localStorage key
* @param defaultValue - default value if no saved value exists
* @param onInit - optional callback to run with the loaded value
* @returns The loaded value (or default if none exists)
*/
export function initializeFromStorage<T>(
key: string,
defaultValue: T,
onInit?: (value: T) => void,
): T {
if (typeof window === 'undefined' || typeof localStorage === 'undefined') {
return defaultValue;
}
try {
const savedValue = localStorage.getItem(key);
const value = savedValue ? (JSON.parse(savedValue) as T) : defaultValue;
if (onInit) {
onInit(value);
}
return value;
} catch (error) {
console.error(`Error initializing ${key} from localStorage, using default. Error:`, error);
// Reset corrupted value
try {
localStorage.setItem(key, JSON.stringify(defaultValue));
} catch (setError) {
console.error(`Error resetting corrupted ${key} in localStorage:`, setError);
}
if (onInit) {
onInit(defaultValue);
}
return defaultValue;
}
}