Stackflow Next

Next.js App Router용 페이지 전환 라이브러리입니다. 기존 URL을 유지하며 브라우저 뒤로가기와 앞으로가기에도 슬라이드를 적용합니다.

설치

npm install @uiwwsw/stackflow-next

설정

Next.js 설정에 withStackflow를 적용하고, 루트 레이아웃에 StackflowProvider를 추가합니다. 전환할 링크에는 StackLink를 사용합니다.

next.config.mjs

import { withStackflow } from '@uiwwsw/stackflow-next/config';

export default withStackflow({});

app/layout.tsx

import type { ReactNode } from 'react';
import { StackflowProvider } from '@uiwwsw/stackflow-next';
import '@uiwwsw/stackflow-next/style.css';

export default function Layout({ children }: { children: ReactNode }) {
  return (
    <html lang="ko">
      <body style={{ margin: 0, height: '100dvh' }}>
        <StackflowProvider>{children}</StackflowProvider>
      </body>
    </html>
  );
}

데모에서 확인하기

데모에서 상세 페이지를 연 뒤 브라우저 뒤로가기를 누르면 슬라이드와 스크롤 복원을 확인할 수 있습니다. Next.js 캐시에 목록이 남아 있으면 입력값도 복원됩니다.

데모의 ‘5.5초 대기’는 응답을 기다린 뒤 전환합니다. ‘스켈레톤’는 로딩 화면으로 먼저 전환합니다.