Smart Recipe Planner I18n

Adding New Translations

1. Open context/SettingsContext.jsx.
2. Locate the main translation dictionary (S object).
3. Inside es (Spanish), en (English), and fr (French), add the new translation key logically grouped (e.g., inside common, auth, feed, settings, etc.).
4. Keep the keys consistent across all languages.

Component Implementation

In React Components (Next.js & Astro Islands):

import { useSettings } from '@context/SettingsContext';

export function ExampleComponent() {
    const { t } = useSettings();

    // GOOD: Reactive and safe fallback
    return (
        <button>{t.common?.save || 'Guardar'}</button>
    );

    // BAD: Hardcoded text
    // return <button>Guardar</button>;
}

In Astro Pages/Components (Static Server):

Astro files .astro run on the server and do not directly subscribe to the client-side Zustand store.

If an Astro page must display reactive translation strings (e.g., the 404 page or Policy pages), extract the translated elements into a React Client Component ("use client") and inject it into the Astro page using the client:load directive.

---
import { TranslatedComponent } from '@components/TranslatedComponent';
---

<!-- Ensure it runs reactively on the client -->
<TranslatedComponent client:load />

Toasts and Alerts

Toast notifications must also be translated:

import { useSettings } from '@context/SettingsContext';
import { useToast } from '@context/ToastContext';

export function useExampleHook() {
   const { t } = useSettings();
   const { showToast } = useToast();

   const doAction = () => {
       showToast(t.common?.success || 'Operación exitosa', 'success');
   };
}