Architecture

Layer	Technology	Notes
API	Hono + factories (createFactory<Context>())	Each feature exports _factory.ts, one or more handlers, and a _router.ts that is mounted inside src/index.ts.
Frontend	React 19 + @tanstack/react-router + Vite SSR	Route files live in apps/iris/src/routes. @tanstack/router-plugin keeps route-tree.gen.ts up to date when you run bun dev.
Data fetching	@tanstack/react-query	QueryClientProvider is wired in routes/__root.tsx. Prefer hooks that wrap apiClient calls.
Auth	better-auth (server) + authClient.useSession() (client)	Authentication middleware attaches the session to Context. Client-side hooks live in apps/iris/src/utils/authentication.ts.
i18n	i18next + JSON namespaces in public/locales/<lng>/translation.json	i18next is configured in apps/iris/src/utils/i18n.ts. Use the useTranslation() hook in components.