Cadencia

Teoría musical para principiantes: escribe unos acordes y Cadencia te dice en qué tonalidad están, qué grado y qué función tiene cada uno, y te deja escucharlos.

PWA en HTML, CSS y JavaScript sin compilación, publicada en GitHub Pages: https://cadenciamusical.github.io/

Probarla en local

Los módulos de JavaScript necesitan un servidor (no basta con abrir el archivo):

python3 -m http.server 8000

y abre http://localhost:8000.

Publicar

GitHub Pages sirve la rama main tal cual (Settings → Pages → «Deploy from a branch», main, carpeta /). No hay paso de compilación.

Cada vez que publiques cambios, sube VERSION en sw.js (cadencia-v1 → cadencia-v2…). Así quien ya tenga la app instalada verá el aviso «Hay una versión nueva» en lugar de quedarse con la antigua en caché. Si añades un archivo, añádelo también a ASSETS en sw.js; las pruebas avisan si se te olvida.

Pruebas

npm test

No hay dependencias que instalar: las pruebas usan el ejecutor integrado de Node (18 o superior).

Estructura

• js/core/: lógica de análisis, sin DOM (parser, tonalidad, grados y funciones, búsqueda de progresiones, modos).
• js/core/catalog.js: catálogo de progresiones y cadencias. Para añadir una, basta con una entrada nueva en grados romanos; las pruebas comprueban que se reconoce en las 12 tonalidades.
• js/ui/: textos didácticos y generación del HTML.
• js/audio.js: sintetizador con la Web Audio API.
• vendor/tonal.mjs: Tonal 6.4.2 empaquetado como un solo módulo, para que funcione sin conexión.
• sw.js: service worker para que funcione sin conexión.
• icons/: logo e iconos de la PWA.