프로젝트 소개

Windrift는 가변적인 내러티브와 인터랙티브한 하이퍼텍스트 스토리를 작성하기 위한 오픈 소스 JavaScript 프레임워크입니다. Harmonia, Stone Harbor, The Ballroom, The Imposter, 그리고 Stone Harbor의 포르투갈어 번역판과 같은 작품을 제작하는 데 사용되었습니다. 이 프로젝트는 Next.js를 기반으로 하며 TypeScript로 작성되어, 여러 스토리를 호스팅할 수 있는 단일 Next.js 애플리케이션으로 동작합니다. 작성자는 Vercel을 통한 호스팅을 포함해 Next.js의 기능과 배포 옵션을 활용할 수 있습니다. 핵심 Windrift 코드는 각 스토리 리포지토리에 함께 번들되므로, 작성자는 자신의 프로젝트에 맞게 라이브러리의 기본 동작을 수정하거나 변경할 수 있습니다. 이 리포지토리는 Node.js를 사용하는 로컬 개발 워크플로를 제공하며, Node 22와 함께 Node Version Manager 사용을 권장합니다. 설치는 npm을 통해 이루어지며, 스토리 식별자를 사용해 새 스토리를 생성하고 로컬 개발 환경을 실행할 수 있는 명령어가 제공됩니다. 배포 옵션을 포함한 추가 명령어는 공식 Windrift 매뉴얼에 문서화되어 있습니다. 문서화는 지속적으로 게시되는 공식 매뉴얼을 통해 제공되며, 이 매뉴얼 자체도 Windrift 스토리로 작성되어 있습니다. 매뉴얼에는 기본적인 사용법부터 고급 사용법까지의 예제 스토리가 포함되어 있으며, Windrift Playground는 예제 스토리의 소스 코드와 함께 추가 데모를 제공합니다. 또한 이 프로젝트에는 Playwright 워크플로를 통한 통합 테스트도 포함되어 있습니다.