Skip to content
watollopPublic

About

To-do PWA local-first: captura en una línea, filtros y sincronización opcional

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Icono de Lista

Lista

Una lista. Nada más.
Escribe lo que tienes en la cabeza. Lista lo pone en su sitio.

Abrir Lista · Cómo se usa · Desarrollo

Lista con tareas de ejemplo: estilo Industrial en ordenador y Clásico en móvil, con subtareas desplegadas.

Sin cuenta para empezar · Funciona sin conexión · iPhone, Android y ordenador

Escribe como piensas

Una tarea, una línea. Las fechas, las etiquetas y las prioridades van contigo.

Llamar mañana #trabajo @ana !alta
Para añadir… Escribe…
Una fecha hoy, mañana, el viernes, 15 nov
Un periodo esta semana, este mes, este trimestre
Un tema o una persona #trabajo, @ana
Una prioridad !alta, !media, !baja
Una repetición cada lunes, cada 2 martes, cada dos semanas, quincenal, cada mes, a diario
Una subtarea <Reservar alojamiento
Otra lista /compra

Pulsa Enter para guardarla. También puedes dictar con el micrófono, una tarea tras otra. Al empezar a escribir desaparece el ejemplo, pero queda una guía discreta de las opciones.

Divide lo grande en pasos

Añade subtareas con <, sin salir del campo de escritura:

Viaje <Billetes mañana !alta <Mochila

Una tarea principal, dos subtareas. Cada paso puede tener su propia fecha, prioridad y etiquetas. La principal lleva un icono de ramas con los pasos hechos (1/2): púlsalo para desplegarlos y plegarlos. Cada grupo se queda como lo dejaste, también al volver, y los pasos siguen en su sitio aunque los marques. Tocar la tarea la abre entera —sus pasos y su editor—; plegar es cosa del icono.

Más sobre las subtareas
  • Para añadir pasos a una tarea existente, pulsa + Subtarea en su editor o el + junto a la casilla de la última subtarea del grupo desplegado.
  • Ahí Añadir (o Enter) guarda ese paso al momento y deja el campo listo para el siguiente; Listo cierra. Esc cierra y descarta lo que estés escribiendo.
  • Completar la principal cierra todos sus pasos; completar el último paso cierra la principal.
  • Reabrir un paso reabre la principal. Reabrir la principal reabre todos sus pasos.
  • Deshacer recupera el estado anterior, sin reabrir pasos que ya estaban hechos.
  • En Clásico, un grupo cerrado se reconoce por el subrayado del color secundario. Al desplegarlo, ese color aparece en las líneas inferiores de sus subtareas, los + y las casillas y tachados de los pasos completados.

Varias listas, si quieres

Empiezas con una, Personal. Puedes renombrarla, pero no borrarla. Para separar la compra o el trabajo, crea otras:

  • Cambiar. Las listas son pestañas, bajo la cabecera en el móvil y junto al logo en el ordenador: Todas · Personal · Compra · +. Toca una para cambiar de lista.
  • Crear. Pulsa +, escribe el nombre y Enter.
  • Renombrar, compartir, borrar. Toca la pestaña de la lista activa (tiene un ▾) para abrir su menú. En el ordenador, doble clic en una pestaña la renombra.
  • Escribir en otra. Leche /compra apunta la tarea en Compra aunque estés en otra lista, sin cambiar de lista. Si la tarea va a otra, el aviso lo dice y Ver te lleva allí.
  • Mover una tarea. En su editor, Mover a… (con más de una lista) elige la nueva. En el ordenador, al pasar el ratón por una tarea aparece el asa ⠿ a la izquierda de la casilla: arrástrala a otra pestaña o a otro día.
  • Ver todo junto. Todas, la primera pestaña, mezcla todas las listas (solo aparece si tienes dos o más). Cada tarea lleva una etiqueta con su lista; tocarla abre esa lista.
  • Con teclado, l pasa a la siguiente lista.
Más sobre las listas
  • Solo cuentan las listas que existen: una errata no crea una lista. Para nombres con espacios, escribe /la-compra.
  • Al editar una tarea, escribir /trabajo la mueve con sus subtareas. Lo que escribes en Todas va a Personal, salvo que lleve /lista.
  • Cada dispositivo recuerda la última lista que abriste: el del trabajo puede abrir Trabajo y el móvil, Personal.
  • Contadores, mini calendario, búsqueda y filtros son de la lista actual. Los temas, las personas y los filtros guardados son comunes a todas.
  • Borrar una lista borra también sus tareas, tras confirmar. Deshacer las recupera.

Listas compartidas

Una lista puede ser de varias personas: la compra con tu pareja, las tareas de casa. Compártela y la editáis juntos, cada uno desde sus dispositivos. Hace falta entrar con Google y el servidor de sincronización, con su migración (ver «Sincronización con Supabase», más abajo).

  • Compartir. Toca otra vez la pestaña de la lista y elige Compartir. Si ya está compartida, ahí ves a sus miembros e invitas a más. Enviar abre el menú de compartir del sistema, o Copiar si el dispositivo no lo tiene. Personal no se comparte.
  • Unirse. El enlace se envía por WhatsApp, Mensajes… (o se copia) y sirve para una sola persona: caduca en 7 días. Quien lo abre entra con Google y pulsa Unirme.
  • En iPhone. Si el enlace se abre en Safari y no en Lista, pulsa Copiar enlace y pégalo en la app, en la caja donde escribes las tareas: Lista lo reconoce y muestra el diálogo para unirte (no crea ninguna tarea).
  • Quién manda. Todos los miembros editan tareas, renombran la lista e invitan. Quien la creó —o quien la herede— quita a personas y borra la lista para todos. Cualquiera puede salir desde el menú de la pestaña (Salir de la lista): la lista desaparece de sus dispositivos y sigue para los demás.
  • Si quien la creó se va. Si sale o borra su cuenta, la lista pasa al miembro más antiguo, que hereda quitar y borrar.
  • Qué ve el servidor. Solo quién comparte con quién, cuántas tareas tiene cada lista y cuándo hay actividad. Nunca los títulos ni los nombres: el contenido va cifrado con la clave de cada lista.
Límites
  • El enlace es la llave. Quien lo tenga antes de que se use puede unirse. Por eso caduca, es de un solo uso y los miembros se ven en la lista.
  • Máximo 50 personas por lista.
  • Al quitar a alguien, la clave no cambia. Ya no puede leer el servidor, pero conserva la clave que tenía.
  • No es instantáneo. Los cambios de los demás llegan en la siguiente sincronización: al volver a la app, al recuperar la conexión o cada 30 segundos mientras usas Lista.
  • Hace falta la migración del servidor. Ejecuta la migración de listas como se indica en Supabase. Sin ella, las listas compartidas no funcionan, pero lo demás sí.

Hazla, táchala, sigue

  • Completa o borra. Desliza a la derecha para tachar; a la izquierda para borrar.
  • Encuentra lo importante. Toca un tema, una persona o una fecha para filtrar. En el móvil, Filtrar (arriba) abre la búsqueda y todos los filtros a la vez; con un filtro puesto, una fila te dice qué filtra y Quitar filtros lo deja todo como estaba.
  • Cada cosa en su día. Las tareas se agrupan en Vencidas, Hoy, Mañana, Esta semana y Próximas. Las vencidas se ven siempre arriba, filtres por la fecha que filtres.
  • Si el filtro esconde lo que acabas de añadir, te avisa. Vale para una tarea, para varias (con subtareas o pegadas) y para lo que llega con «Compartir con Lista»: el aviso lo dice y Ver todo quita el filtro.
  • Tu semana de un vistazo. Arriba de los filtros (en el móvil, al tocar Filtrar) verás cuántas tareas tienes hoy, las vencidas, cuántas has hecho hoy (una moneda por cada una: salta al completar) y cuántas tienes cada uno de los próximos 7 días, todo de la lista actual. Toca un día para ver solo sus tareas (y las vencidas); tócalo otra vez (o vuelve a abrir Lista) para verlas todas.
  • Cambia de planes. Toca una tarea para editarla: se guarda sola al pulsar Enter o al salir. Mientras la editas, la casilla se convierte en el asa ⠿: arrástrala a otro bloque (Hoy, Mañana, Esta semana…) para cambiarla de día. En el ordenador no hace falta abrirla: el asa aparece a la izquierda de la casilla al pasar el ratón. Debajo tienes + Subtarea, Calendario, Mover a… (con más de una lista) y Borrar. Con teclado, M la pasa a mañana.
  • Deshacer con el teclado. ⌘Z (Ctrl+Z en Windows) deshace el último cambio de la lista —completar, borrar, mover—, y repetido, los anteriores. Dentro de un campo de texto sigue deshaciendo lo escrito.
  • Para mañana. Arrastra la tarea al bloque Mañana (en ordenador, también m con la tarea seleccionada); Deshacer la devuelve a su fecha anterior.
  • Abre los enlaces. Una dirección web en una tarea se muestra corta; tócala para abrirla.

A tu manera

Dos estilos, la misma calma. Clásico, en blanco y negro; Industrial, con gris cálido, letra de puntos y acento naranja. Ambos con tema claro, oscuro o el del sistema.

Un toque de color. En Ajustes → Apariencia, Clásico permite elegir un color secundario: rosa (por defecto), azul, verde, naranja o uno personalizado. Industrial conserva su naranja y no muestra la paleta; tu elección se guarda para cuando vuelvas a Clásico.

Solo lo que seleccionas. La línea izquierda marca únicamente la fila seleccionada. Clásico usa el color secundario para las tareas con subtareas y sus pasos; Industrial, su naranja.

Qué versión llevas. Al pie de Ajustes, junto a la firma, aparecen la versión, el día y la hora en que se compiló y el commit. Sirve para comprobar que tienes lo último tras una actualización.

Novedades. Al actualizar, una tarjeta te avisa de lo nuevo una sola vez. Siempre puedes releerlo en Ajustes → Ayuda → Novedades.

En español o en inglés. Lista sale en español si tu navegador lo tiene entre sus idiomas; si no, en inglés. Puedes cambiarlo en Ajustes → Apariencia → Idioma · Language. En inglés todo cambia: la bienvenida, los menús y también lo que escribes (tomorrow, every 2 tuesdays, !high, due:2026-11-15). El nombre, Lista, no se traduce.

Igual en todos tus dispositivos. Con la misma cuenta, el tema, el estilo, el color y el idioma se sincronizan. Si cambias algo sin conexión, se envía al volver; ante cambios simultáneos gana el más reciente.

Tus tareas, contigo

Todo se guarda primero en tu dispositivo. Puedes usar Lista sin cuenta y sin conexión; si quieres llevar tus tareas del móvil al ordenador, entra con Google. Desde Ajustes → Tus datos puedes exportarlo todo o borrarlo todo.

Para tenerla siempre a mano, instálala como una app:

  • iPhone: Compartir → Añadir a pantalla de inicio.
  • Android y ordenador: Instalar app desde el navegador.

Desarrollo

Vite · TypeScript · Preact · Dexie / IndexedDB · Supabase · Cloudflare Pages.

Con Node.js 22:

npm ci
npm run dev     # http://localhost:5173

Sin configurar nada más, funciona en local sin sincronización.

Tests, cobertura y build
npm test
npm run test:coverage
npm run build
npm run test:supabase   # listas compartidas contra un Supabase real en Docker

La cobertura incluye todo src/ y genera informes LCOV y JSON en coverage/, excluidos de Git.

npm run test:supabase levanta un Supabase local con supabase/schema.sql (necesita Docker o Colima) y repite los flujos de compartir con cuentas de prueba. Nunca toca producción. Para pararlo: npm run test:supabase -- stop.

Sincronización con Supabase (opcional)
  1. Crea un proyecto en Supabase y ejecuta supabase/schema.sql.
  2. Copia .env.example a .env con VITE_SUPABASE_URL y VITE_SUPABASE_ANON_KEY.
  3. Activa Google en Authentication → Providers y añade tu URL en Redirect URLs. Desactiva el proveedor Email: la app solo entra con Google.

Si ya tenías una instalación: para sincronizar la apariencia, ejecuta la migración de ajustes en el SQL editor, o vuelve a ejecutar el esquema. Utiliza el tipo setting, sin duplicar preferencias ni cambiar las políticas por usuario. Un servidor antiguo rechazará los envíos de apariencia hasta actualizarlo.

Límites del servidor: ejecuta la migración de límites en el SQL editor, o vuelve a ejecutar el esquema. Añade un tope de 64 KiB por registro y borra cada 15 minutos los enlaces entre dispositivos caducados (con pg_cron, si el proyecto lo tiene disponible).

Listas compartidas: ejecuta la migración de listas en el SQL editor, o vuelve a ejecutar el esquema. Crea las tablas de listas, miembros e invitaciones, con permisos por miembro; el contenido va cifrado con la clave de cada lista y el servidor no lo puede leer. Sin ella, todo lo demás funciona igual.

La apariencia guardada en el dispositivo se migra una sola vez, sin sobrescribir una elección ya sincronizada. Si varios dispositivos tenían elecciones antiguas distintas, convergen en la aceptada por el servidor. Al actualizar, la base local fuerza una descarga completa para recuperar preferencias que una versión anterior pudo ignorar.

Arquitectura y despliegue
  • Local-first: cada cambio se guarda al instante y se sincroniza en segundo plano. Ante conflictos gana el más reciente.
  • Datos separados por usuario: RLS en Supabase.
  • Sin conexión: service worker propio, con actualización automática.
  • Recursos locales: fuentes incluidas en la app y CSP estricta.
Carpeta Contenido
src/parser/ Interpreta lo que escribes
src/data/ Base de datos local
src/sync/ Sincronización con Supabase
src/ui/ Pantallas y estilos
src/pwa/ Service worker

Cada merge a main ejecuta los tests y publica en Cloudflare Pages mediante deploy.yml. Necesita CLOUDFLARE_API_TOKEN y CLOUDFLARE_ACCOUNT_ID, además de los secretos de Supabase si usas sincronización.

Código Do Norte ♥ Coruña

About

To-do PWA local-first: captura en una línea, filtros y sincronización opcional

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages