À propos du projet

Windrift est un framework JavaScript open source destiné à l'écriture de récits évolutifs et d'histoires hypertextes interactives. Il a servi à créer des œuvres telles que Harmonia, Stone Harbor, The Ballroom, The Imposter, ainsi qu'une traduction portugaise de Stone Harbor. Le projet repose sur Next.js et est écrit en TypeScript ; il fonctionne comme une application Next.js unique pouvant héberger plusieurs histoires. Les auteurs peuvent exploiter les fonctionnalités et les options de déploiement de Next.js, y compris l'hébergement via Vercel. Étant donné que le code principal de Windrift est inclus dans chaque dépôt d'histoire, les auteurs peuvent modifier ou altérer le comportement fondamental de la bibliothèque pour leurs propres projets. Le dépôt fournit un flux de travail de développement local utilisant Node.js et recommande Node Version Manager avec Node 22. L'installation s'effectue via npm, et des commandes permettent de créer une nouvelle histoire à partir d'un identifiant d'histoire ainsi que de lancer l'environnement de développement local. Des commandes supplémentaires, notamment des options de déploiement, sont documentées dans le manuel officiel de Windrift. La documentation est assurée par un manuel officiel publié en continu, lui-même écrit comme une histoire Windrift. Ce manuel comprend des histoires d'exemple allant d'une utilisation basique à avancée, et le Windrift Playground propose des démonstrations supplémentaires dont le code source est disponible pour les histoires d'exemple. Le projet inclut également des tests d'intégration via des workflows Playwright.