react-scroll-utilities
Mía, del primer commit a npm: la diseñé, la construí, la probé y la publiqué, y aprendí a hacer cada una de esas cosas en el camino.
Por qué existe
Estaba haciendo páginas en WordPress que necesitaban animaciones con el scroll, escritas a mano en JavaScript puro, y era muy difícil. Así que pensé: debería hacer una librería. Y la hice en React, como desafío, para entender React de verdad. Aprendí mucho equivocándome.
El resultado es una librería liviana de hooks y componentes: qué tan cerca está un elemento de la pantalla, hacia dónde scrolleas, valores y colores que cambian con el scroll, y formas que se mueven con él.
Decisiones clave
-
Matemática del colegio
Las animaciones son matemática. Saqué la lógica a funciones chicas basadas en ecuaciones que sabía del colegio, y las verifiqué a mano con cuadernos y una calculadora gráfica antes de confiar en el código.
-
Un render, no tres
Los eventos de scroll se disparan todo el tiempo, así que tuve que cuidar en React no renderizar más de una vez por cambio. Un solo ScrollWatcher arriba de la app lee el scroll y lo comparte con cada hook.
Míralo funcionar
Lo difícil
No sabía bien TypeScript, ni cómo armar una librería de npm, compilar TypeScript a JavaScript, o publicarla y entregarla. Aprendí todo fallando: hay versiones de parche que no funcionaban, publicadas solo para ver si el paquete se instalaba. Mis commits hoy dan risa, llenos de "visual testing" y uno que solo dice "added console.log to know the version".
Me llevó un tiempo, porque aprendía rompiendo cosas. Fue muy divertido.
Dónde está hoy
Terminada: 16 versiones en npm, la última en enero de 2023. La tengo en el corazón, y es la librería que me consiguió el trabajo en dotCMS.