Acerca de keyduelo

Qué es keyduelo

keyduelo es una aplicación web con dos pantallas. La página principal es un test de mecanografía que arranca con tu primera pulsación y reporta WPM, WPM bruto y precisión. La página play es un lobby donde cualquiera crea una sala, comparte un código de 5 letras y compite con amigos sobre el mismo texto, con barras de progreso en vivo, cuenta regresiva sincronizada y un ranking calculado en el servidor. No hay cuentas, ni anuncios, ni rastreo.

Quién lo construye

keyduelo es un proyecto personal de Jaime Aza, ingeniero de software colombiano que construye productos web con Next.js, Django y agentes de IA. No es una empresa. El código, las decisiones y los errores están documentados en abierto en github.com/Jjat00/keyduelo.

Cómo está construido

• Front end: Next.js 16 con App Router, React 19 y Tailwind CSS 4, desplegado en Vercel.
• Salas: un Worker de Cloudflare con Durable Objects. Un objeto por sala guarda los jugadores, el texto, el reloj y el ranking; un registro único alimenta el lobby público.
• Tiempo real: WebSockets con hibernación, así que una sala inactiva no cuesta nada.
• Motor de tipeo: una máquina de estados en TypeScript puro, compartida por navegador y servidor, sin React dentro, para que el mismo código pueda validar resultados.
• Texto: un generador sobre 282 palabras comunes del inglés con puntuación opcional, que evita repetir la misma palabra dos veces seguidas.

Privacidad

No hay nada que registrar y nada se rastrea. Tu tema, tu sonido y tus ajustes del test viven en el almacenamiento local de tu navegador, igual que tu apodo. Los tests individuales nunca salen de tu dispositivo. En una sala, tu navegador envía contadores de progreso (posición y WPM) al servidor de la sala, nunca las teclas que pulsas, y la sala desaparece de la memoria cuando el anfitrión se va.

Inspiración y licencia

keyduelo está inspirado en Monkeytype: el texto que se desplaza, el cursor, las métricas y el tono en minúsculas vienen de allí. No incluye código de Monkeytype; el motor, los hooks, los componentes, el worker y el protocolo se escribieron desde cero y la lista de palabras es una selección propia. Las paletas Nord, Dracula y Gruvbox se usan bajo sus licencias MIT. keyduelo se publica bajo GPL-3.0.

Los sonidos de las teclas tampoco son nuestros. Los siete perfiles de switches — KAT, Cherry, MT3, XDA, OEM, SA y DSA — son las grabaciones de kliq, una app libre y de código abierto de sonidos de teclado mecánico para macOS hecha por Crafter Station, con diseño de sonido de Cris. Se usan bajo su licencia MIT desde github.com/crafter-station/kliq. Si te gusta cómo suena escribir acá, kliq te da lo mismo en todo tu Mac.

Qué podría venir después

En estudio, sin orden particular: listas de palabras en otros idiomas (español primero), textos propios para las salas, y cuentas opcionales con historial y clasificaciones. Nada de esto es una promesa; el README del repositorio registra lo que realmente se publica.

Contacto y contribuciones

Errores, ideas y pull requests van a los issues de GitHub. El README explica la arquitectura, la configuración local con pnpm y wrangler, y el razonamiento detrás de las principales decisiones técnicas.