기존 Next.js 프로젝트에 Apps in Toss를 연동

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

안녕하세요.

기존 Next.js 프로젝트에 Apps in Toss를 연동하고 있습니다.

현재 환경은 다음과 같습니다.

Next.js 16.2.9
React 19.2.4
React DOM 19.2.4
@apps-in-toss/web-framework 2.10.6

공식 문서(기존 웹 프로젝트에 SDK 연동하기)를 참고하여

npm install @toss/tds-mobile @toss/tds-mobile-ait @emotion/react

를 설치하려고 했는데 아래와 같은 peer dependency 오류가 발생합니다.

@toss/tds-mobile@2.5.0
peerDependencies:
react: ^16.8.3 || ^17 || ^18
react-dom: ^16.8.3 || ^17 || ^18

현재 React 19를 사용 중이라 npm에서 ERESOLVE unable to resolve dependency tree가 발생합니다.

질문드립니다.

Apps in Toss는 현재 React 19 / Next.js 16을 공식적으로 지원하나요?
React 19 환경에서는 --legacy-peer-deps를 사용하여 설치하는 것이 권장되는 방법인가요?
아니면 React 18 환경으로 구성하는 것이 현재 공식 권장 사항인가요?
React 19 지원 예정이 있다면 일정이나 권장 가이드가 있을까요?

안녕하세요 :slight_smile:
현재 가장 안정적인 연동을 위해서는 React 18 환경으로 구성하시는 것을 권장드립니다.