⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
'use client';
import { MutationCache, QueryClient, QueryClientProvider } from '@tanstack/react-query';
import { useRef, useState, type ReactNode } from 'react';
import { useLocale, useTranslations } from 'next-intl';
import { Direction } from 'radix-ui';
import { toast } from 'sonner';
import { ApiError } from '@/lib/api/core/client';
import { localeDirection, type Locale } from '@/i18n/locales';
import { HotkeysProvider } from '@/context/useHotkeys';
import { SyncProvider } from '@/context/syncContext';
import { RelativeTimeProvider } from '@/context/relativeTimeContext';
import { Toaster } from '@/components/ui/sonner';
import PreferencesSync from '@/components/preferences-sync';
import SessionScope from '@/components/session-scope';
import SigningOutGate from '@/components/signing-out-gate';
// The message shown for a failed mutation: the API's `{ error }` text (carried by
// ApiError) when present, otherwise a generic fallback.
function errorMessage(error: unknown, fallback: string): string {
if (error instanceof ApiError) return error.message;
if (error instanceof Error && error.message) return error.message;
return fallback;
}
export function Providers({ children }: { children: ReactNode }) {
const t = useTranslations('common');
// Radix reads the direction from this context, not from the CSS: without it a
// menu keeps left-to-right arrow-key navigation and alignment even once the
// layout is mirrored.
const dir = localeDirection(useLocale() as Locale);
// The cache is built once, so the toast reads the fallback through a ref the
// render refreshes; switching locale then reaches errors too.
const fallback = useRef(t('genericError'));
fallback.current = t('genericError');
const [queryClient] = useState(
() =>
new QueryClient({
// Every failed mutation is surfaced as a toast, so no call site has to wire
// its own error UI. A mutation that owns its error display can opt out with
// `meta: { suppressErrorToast: true }`. Reads are not toasted — a failed
// query renders its own empty/loading state in place.
mutationCache: new MutationCache({
onError: (error, _vars, _ctx, mutation) => {
if (mutation.meta?.suppressErrorToast) return;
toast.error(errorMessage(error, fallback.current));
},
}),
defaultOptions: {
// Mutations invalidate what they change. Changes made by other clients
// arrive through the sync poll (SyncProvider): it refetches on window focus
// and invalidates only the scopes that moved, so nothing else does.
queries: {
staleTime: 15_000,
refetchOnWindowFocus: false,
retry: 1,
},
},
}),
);
return (
<QueryClientProvider client={queryClient}>
<Direction.Provider dir={dir}>
<SessionScope />
<PreferencesSync />
<SyncProvider>
<RelativeTimeProvider>
<HotkeysProvider>
<SigningOutGate>{children}</SigningOutGate>
</HotkeysProvider>
</RelativeTimeProvider>
</SyncProvider>
<Toaster position={dir === 'rtl' ? 'bottom-left' : 'bottom-right'} dir={dir} richColors />
</Direction.Provider>
</QueryClientProvider>
);
}