Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { useState, useEffect } from 'react';
// Shared sidebar-list fetch pattern: load once on mount, refresh on window
// focus (debounced 30s so tab-switching doesn't hammer the API), and guard
// against re-rendering the consumer when the list is unchanged via an
// id|name signature compare. Sorts by name (case-insensitive) so the caller
// always receives a stable, display-ready array.
//
// `fetchFn` must accept `{ silent: true }` (it owns its own error handling via
// the warn below, so the API helper should not also toast) and resolve to an
// array. Pass a stable function reference (a module-level `api.*` export is
// stable); `label` is a plain string used only in the warn message.
const sigOf = (list) => list.map((item) => `${item.id}|${item.name}`).join('||');
const byName = (a, b) =>
(a.name || '').localeCompare(b.name || '', undefined, { sensitivity: 'base' });
export function useFocusRefreshedList(fetchFn, label = 'list') {
const [items, setItems] = useState([]);
useEffect(() => {
let lastSuccessAt = 0;
let cancelled = false;
const load = () => {
fetchFn({ silent: true })
.then((result) => {
if (cancelled) return;
lastSuccessAt = Date.now();
const next = (Array.isArray(result) ? result : []).slice().sort(byName);
setItems((prev) => (sigOf(prev) === sigOf(next) ? prev : next));
})
.catch((err) => {
console.warn(`⚠️ Sidebar ${label} fetch failed: ${err?.message || err}`);
});
};
load();
const onFocus = () => {
if (Date.now() - lastSuccessAt < 30_000) return;
load();
};
window.addEventListener('focus', onFocus);
return () => {
cancelled = true;
window.removeEventListener('focus', onFocus);
};
}, [fetchFn, label]);
return items;
}