chore: release main (#970)

* chore: release main

* chore(app): add migration manifest and update MIGRATION.md for v10.0.0

---------

Co-authored-by: Philipp Kaiser <philipp.kaiser@frachtwerk.de>

Author: qhantom

.release-please-manifest.json

@@ -1,8 +1,8 @@
 {
-  "packages/types": "6.4.0",
-  "packages/lib": "9.6.0",
-  "packages/app": "9.5.0",
-  "packages/docs": "4.5.0",
-  "packages/prettier-config": "1.5.2",
-  "packages/eslint-config": "2.5.0"
+  "packages/types": "6.5.0",
+  "packages/lib": "10.0.0",
+  "packages/app": "10.0.0",
+  "packages/docs": "4.6.0",
+  "packages/prettier-config": "1.5.3",
+  "packages/eslint-config": "2.5.1"
 }

packages/app/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [10.0.0](https://github.com/Frachtwerk/essencium-frontend/compare/essencium-app-v9.5.0...essencium-app-v10.0.0) (2026-04-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* **lib:** Consumers must wrap the app with next-intl's NextIntlClientProvider instead of react-i18next's I18nextProvider.
+
+### Features
+
+* **app:** add API token feature ([#972](https://github.com/Frachtwerk/essencium-frontend/issues/972)) ([106c7e8](https://github.com/Frachtwerk/essencium-frontend/commit/106c7e83a2ddeee9333c8782514d5c2885891494))
+* **app:** hydrate user state from jwt claims ([1f2c6e8](https://github.com/Frachtwerk/essencium-frontend/commit/1f2c6e884477b10bf88b953a2506e7e453149c05))
+
+
+### Bug Fixes
+
+* address code review feedback on migration tooling ([165b89c](https://github.com/Frachtwerk/essencium-frontend/commit/165b89c89184e1ac9131424f10773ffff61d2beb))
+* correct manifest schema violations in v6.0.0 through v7.3.0 ([53b61ef](https://github.com/Frachtwerk/essencium-frontend/commit/53b61efcf92c5f001549573c8e633aab2f6f0740))
+* correct manifest schema violations in v7.4.0 through v9.4.0 ([b4b69bd](https://github.com/Frachtwerk/essencium-frontend/commit/b4b69bd92303fcac4517cbdba4461143b6e74443))
+* exclude flaky e2e from pipeline ([#971](https://github.com/Frachtwerk/essencium-frontend/issues/971)) ([da0c900](https://github.com/Frachtwerk/essencium-frontend/commit/da0c9005d0d1a1ad199808da2ecdf9c3c46a5c73))
+* remaining schema violations in v7.4.0 and v7.8.0 manifests ([1938fc0](https://github.com/Frachtwerk/essencium-frontend/commit/1938fc052ae9f8d8aef15a1d05932b977c797240))
+
+
+### Code Refactoring
+
+* **lib:** migrate all components to next-intl ([f64ca72](https://github.com/Frachtwerk/essencium-frontend/commit/f64ca72616612bced7817414ec4861a2ff12ea16))
+
 ## [9.5.0](https://github.com/Frachtwerk/essencium-frontend/compare/essencium-app-v9.4.6...essencium-app-v9.5.0) (2026-03-10)
 
 

packages/app/MIGRATION.md

@@ -1,41 +1,201 @@
 # Migrations
 
-## [Unreleased]()
+## [10.0.0 (2026-04-16)](https://github.com/Frachtwerk/essencium-frontend/releases/tag/essencium-app-v10.0.0)
 
-### Add API token management (https://github.com/Frachtwerk/essencium-frontend/pull/929)
+### Migrate from i18next to next-intl (https://github.com/Frachtwerk/essencium-frontend/pull/967)
 
-#### `packages/types/src/right.ts`
+#### `packages/app/package.json`
 
-- add `API_TOKEN`, `API_TOKEN_ADMIN`, and `SESSION_TOKEN_ADMIN` to the `RIGHTS` enum
+- remove `i18next`, `react-i18next`, `next-i18n-router`, `i18next-resources-to-backend`
+- add `next-intl`
 
-#### `packages/types/src/apiToken.ts`
+#### `packages/app/next.config.mjs` (renamed from `next.config.js`)
 
-- add file with `ApiTokenOutput`, `ApiTokenInput`, `ApiTokenStatus`, `FilterObjectApiToken` types and Zod schemas
+- convert from CJS (`module.exports`) to ESM (`export default`)
+- wrap config with `withNextIntl()` from `next-intl/plugin`
+- add `turbopack: {}` option
 
-#### `packages/app/src/api/apiToken.ts`
+#### `packages/app/src/i18n/routing.ts`
 
-- add file with API hooks: `useGetApiTokens`, `useGetApiToken`, `useCreateApiToken`, `useDeleteApiToken`, `useRevokeApiToken`, `useGetAllApiTokens`, `useGetAllApiTokensGrouped`, `useGetTokenExpirationInfo`
+- add file: defines locale routing via `defineRouting()` from `next-intl/routing`
+- exports `routing` (locales, defaultLocale) — used throughout the app
 
-#### `packages/app/src/api/me.ts`
+#### `packages/app/src/i18n/request.ts`
 
-- rewrite `useGetMe` hook with explicit `useQuery` implementation to gate on auth token availability
+- add file: server-side `getRequestConfig()` from `next-intl/server`
+- loads static JSON translation files and deep-merges backend translation overrides
+- replaces the old `initTranslations()` function from `src/config/i18n.ts`
 
-#### `packages/app/src/utils/dayjs.ts`
+#### `packages/app/src/i18n/navigation.ts`
 
-- add file with dayjs locale configuration (de/en)
+- add file: locale-aware navigation exports via `createNavigation(routing)`
+- provides `Link`, `redirect`, `usePathname`, `useRouter`, `getPathname`
+- use these instead of `next/navigation` for locale-aware routing
 
-#### `packages/app/src/app/[locale]/providers.tsx`
+#### `packages/app/src/middleware.ts`
 
-- wrap app with Mantine `DatesProvider` for date picker locale support
-- accept `locale` prop from layout
+- add file: `createMiddleware(routing)` from `next-intl/middleware`
+- replaces `src/proxy.ts` (which used `next-i18n-router`)
+
+#### `packages/app/src/proxy.ts`
+
+- remove file: replaced by `src/middleware.ts`
+
+#### `packages/app/src/config/i18n.ts`
+
+- `initTranslations()` removed — replaced by next-intl's `getRequestConfig`
+- file now only re-exports `routing as i18nConfig` for backwards compatibility
+
+#### `packages/app/src/components/provider/translationProvider.tsx`
+
+- `TranslationProvider` component gutted and deprecated
+- root layout now wraps children directly with `NextIntlClientProvider` from `next-intl`
+
+#### `packages/app/src/hooks/useAddTranslation.ts`
+
+- hook gutted and deprecated
+- backend translation overrides are now loaded server-side in `src/i18n/request.ts`
+
+#### `packages/app/src/hooks/index.ts`
+
+- remove export of `useAddTranslation`
 
 #### `packages/app/src/app/[locale]/layout.tsx`
 
+- replace `TranslationProvider` with `NextIntlClientProvider` from `next-intl`
+- replace `initTranslations(locale)` with `getMessages()` from `next-intl/server`
+- `generateStaticParams` uses `routing.locales` instead of `i18nConfig.locales`
 - pass `locale` prop to `Providers`
 
-#### `packages/app/src/globals.css`
+#### `packages/app/src/app/[locale]/providers.tsx`
+
+- add `DatesProvider` from `@mantine/dates` wrapping children for date picker locale support
+- accept `locale` prop from layout
+- add side-effect `import '@/utils/dayjs'` for locale registration
+
+#### `packages/app/src/app/[locale]/(public)/layout.tsx`
+
+- migrate from i18next to next-intl patterns
+
+#### `packages/app/src/components/layouts/AuthLayout.tsx`
+
+- replace `useTranslation()` with `useTranslations()` from `next-intl`
+- replace `i18n.language` with `useLocale()` from `next-intl`
+- remove `useAddTranslations(i18n)` usage
+- remove `i18n.changeLanguage()` call (locale handled via URL)
+
+#### `packages/app/src/components/RouteProtector.tsx`
+
+- replace `useTranslation` with `useTranslations` from `next-intl`
+- replace `i18nConfig` with `routing` from `@/i18n/routing`
+
+#### `packages/app/src/app/[locale]/(main)/admin/translations/TranslationsView.tsx`
+
+- replace `getI18n()` / `i18n.language` with `useLocale()` from `next-intl`
+- accept `staticMessages` prop (preloaded by page.tsx via dynamic `import()`)
+- replace `i18n.addResourceBundle()` with `staticMessages[locale]` lookup
+- replace `window.location.reload()` with `router.refresh()`
+- use `routing.locales` instead of `i18nConfig.locales`
+- fix component name typo: `TranlsationView` → `TranslationsView`
+
+#### `packages/app/src/app/[locale]/(main)/admin/translations/page.tsx`
+
+- load static translation messages for all locales via dynamic `import()`
+- pass as `staticMessages` prop to `TranslationsView`
+
+#### `packages/app/src/utils/withBaseStylingShowNotification.ts`
+
+- **BREAKING for callers:** no longer internally calls `getI18n()`
+- now accepts `t` as an optional `TranslateFunction` parameter
+- all callers must pass the `t` function from `useTranslations()` explicitly
+
+#### All view components
 
-- add `@mantine/dates/styles.layer.css` import
+- replace `import { useTranslation } from 'react-i18next'` with `import { useTranslations } from 'next-intl'`
+- replace `const { t } = useTranslation()` with `const t = useTranslations()`
+
+Changed files:
+- `src/app/[locale]/(main)/admin/rights/RightsView.tsx`
+- `src/app/[locale]/(main)/admin/roles/RolesView.tsx`
+- `src/app/[locale]/(main)/admin/users/UsersView.tsx`
+- `src/app/[locale]/(main)/admin/users/[id]/UpdateUserView.tsx`
+- `src/app/[locale]/(main)/admin/users/add/AddUserView.tsx`
+- `src/app/[locale]/(main)/legal-notice/LegalNoticeView.tsx`
+- `src/app/[locale]/(main)/privacy-policy/PrivacyPolicyView.tsx`
+- `src/app/[locale]/(main)/profile/ProfileView.tsx`
+- `src/app/[locale]/(public)/set-password/SetPasswordView.tsx`
+- `src/app/[locale]/(main)/translations/_components/TranslationsChangeForm.tsx`
+- `src/api/contact.ts`
+
+#### All page.tsx files
+
+- simplify `generateMetadata`: replace `initTranslations(locale)` with `getTranslations()` from `next-intl/server`
+- remove `Props`/`params`/`ResolvingMetadata` types — page components no longer receive `params` prop
+
+Changed files:
+- `src/app/[locale]/(main)/admin/rights/page.tsx`
+- `src/app/[locale]/(main)/admin/roles/page.tsx`
+- `src/app/[locale]/(main)/admin/users/page.tsx`
+- `src/app/[locale]/(main)/admin/users/[id]/page.tsx`
+- `src/app/[locale]/(main)/admin/users/add/page.tsx`
+- `src/app/[locale]/(main)/contact/page.tsx`
+- `src/app/[locale]/(main)/legal-notice/page.tsx`
+- `src/app/[locale]/(main)/privacy-policy/page.tsx`
+- `src/app/[locale]/(main)/page.tsx`
+- `src/app/[locale]/(public)/login/page.tsx`
+- `src/app/[locale]/(public)/set-password/page.tsx`
+
+### Raise Node.js minimum version to 24
+
+#### `packages/app/package.json`
+
+- change `engines.node` from `>=20` to `>=24`
+- update `volta.node` from `20.15.0` to `24.0.0`
+
+### Hydrate user state from JWT claims (https://github.com/Frachtwerk/essencium-frontend/pull/996)
+
+#### `packages/app/src/api/auth-atoms.ts`
+
+- add file: Jotai atoms for auth state extracted from `auth.ts`
+- exports `authTokenAtom`, `userAtom`, `userRightsAtom`, `isSsoAtom`, `ssoProviderAtom`
+- import atoms from this file instead of `auth.ts`
+
+#### `packages/app/src/api/auth.ts`
+
+- add `getAuthStateFromToken(token)`: parses JWT claims into `UserOutput` + rights array
+- `useCreateToken` and `useRenewToken`: hydrate `userAtom`/`userRightsAtom` immediately on success
+- `useLogout`: resets atoms via Jotai setters instead of `localStorage.removeItem`
+- auth atoms moved to `auth-atoms.ts` and re-exported
+
+#### `packages/app/src/api/api.ts`
+
+- add `getStoredAuthToken()` with safe JSON.parse (handles raw and JSON-stringified tokens)
+- `clearAuthState()` uses `getDefaultStore()` from `jotai/vanilla` to reset atoms
+- 401 interceptor: add SSR guard, fix login path check to `.includes('/login')` for locale-aware paths
+
+#### `packages/app/src/api/me.ts`
+
+- rewrite `useGetMe` from `createUseFind` factory to a direct `useQuery` hook
+- explicitly depends on `authTokenAtom` so query is disabled when no token is present
+
+#### `packages/app/src/utils/parseJwt.ts`
+
+- return type changed from `Record<string, number>` to `JwtPayload` (`Record<string, unknown> & { expiringIn: number }`)
+- add validation: returns `null` if `payload.exp` is not a number
+
+### Add API token management (https://github.com/Frachtwerk/essencium-frontend/pull/972)
+
+#### `packages/types/src/right.ts`
+
+- add `API_TOKEN`, `API_TOKEN_ADMIN`, and `SESSION_TOKEN_ADMIN` to the `RIGHTS` enum
+
+#### `packages/types/src/apiToken.ts`
+
+- add file with `ApiTokenOutput`, `ApiTokenInput`, `ApiTokenStatus`, `FilterObjectApiToken` types and Zod schemas
+
+#### `packages/app/src/api/apiToken.ts`
+
+- add file with API hooks: `useGetApiTokens`, `useGetApiToken`, `useCreateApiToken`, `useDeleteApiToken`, `useRevokeApiToken`, `useGetAllApiTokens`, `useGetAllApiTokensGrouped`, `useGetTokenExpirationInfo`
 
 #### `packages/app/src/app/[locale]/(main)/profile/_components/ApiTokensSection.tsx`
 
@@ -69,10 +229,6 @@
 
 - add translations for `navigation.apiTokens`, `profileView.apiTokens`, `apiTokensView`, and `actions.close`
 
-#### `packages/lib/src/theme.css`
-
-- add directional spacing utilities (`py-*`, `px-*`, `pt-*`, `pb-*`, `pl-*`, `pr-*`, `my-*`, `mx-*`, `mt-*`, `mb-*`, `ml-*`, `mr-*`) mapped to Mantine spacing tokens
-
 ## [9.5.0 (2026-03-10)]()
 
 ### Enable React Compiler (https://github.com/Frachtwerk/essencium-frontend/pull/908)