Skip to content

macarthuror/stroke-speach

Repository files navigation

🗣️ Stroke Speech

Stroke Speech Logo

Status Live PWA Ready Nuxt 4 i18n ES | EN License MIT

Aplicación web AAC (Augmentative and Alternative Communication) enfocada en personas con dificultades del habla, especialmente diseñada para facilitar el proceso de recuperación post-ictus (derrame cerebral).


🌍 Abstract (English)

Stroke Speech is an accessible, Progressive Web App (PWA) designed to provide Augmentative and Alternative Communication (AAC) for stroke survivors and individuals with speech impairments. By utilizing the Web Speech API (Text-to-Speech), it allows users to quickly select customizable word and phrase cards to communicate their daily needs. The app is fully internationalized (Spanish & English UI) and lets users configure the speech voice language, pitch, and rate. With a simple, high-contrast UI and full offline support, Stroke Speech aims to bridge the communication gap during rehabilitation, ensuring users have a voice anywhere, anytime.


🎯 Descripción y Objetivos

Stroke Speech permite crear, personalizar y reproducir tarjetas de comunicación por voz para necesidades rápidas de uso diario.

Objetivos clave:

  • Comunicación inmediata: Facilitar la expresión mediante tarjetas de palabras y frases preconfiguradas.
  • Accesibilidad máxima: Interfaz simple, clara, de alto contraste y con áreas táctiles grandes.
  • Disponibilidad total: Funcionar como PWA instalable con soporte 100% offline.
  • Personalización de voz: Control completo del idioma, tono (pitch) y velocidad (rate) de la síntesis de voz.

✨ Características Principales

  • 🗂️ Tarjetas Personalizables: Crea y organiza tarjetas de palabras y frases.
  • 🔊 Síntesis de Voz (TTS): Reproducción mediante SpeechSynthesis con soporte para 13 idiomas/variantes.
  • 🎛️ Ajustes de Voz: Elige idioma de voz, tono (pitch) y velocidad (rate) persistidos en localStorage.
  • 🌐 Interfaz Bilingüe (i18n): UI completa en Español e Inglés, con selector de idioma en el header.
  • 🎨 Identificación Visual: Selector de color y soporte de emojis por tarjeta.
  • 🗑️ Gestión Segura: Modo "eliminar" controlado desde el header para evitar toques accidentales.
  • 📱 Experiencia Nativa (PWA): Instalable en escritorio (Chrome/Edge) y móvil (Android/iOS mediante A2HS).
  • 📶 Modo Offline: Soporte sin conexión a internet garantizado por Service Workers.
  • 🔄 Auto-Update: Actualización automática de la PWA tras nuevos despliegues.

🏗️ Arquitectura y Rutas

La aplicación está diseñada con una navegación plana para evitar que el usuario se pierda:

Ruta Descripción
/ Tarjetas de palabras (Inicio)
/phrases Tarjetas de frases complejas
/settings Ajustes de voz: idioma, pitch, rate y botón de restaurar
/about Información del proyecto

🗣️ Idiomas de Voz Soportados

La configuración de voz admite las siguientes voces TTS (dependiendo del navegador/SO):

es-MX · es-ES · en-US · en-GB · zh-CN · hi-IN · fr-FR · ar-SA · pt-BR · ru-RU · de-DE · ja-JP · id-ID


💻 Tecnologías Usadas

Este proyecto está construido con un stack moderno y enfocado en el máximo rendimiento:

Framework y UI:

Internacionalización:

PWA y Rendimiento:

Utilidades:

  • VueUse (@vueuse/core, @vueuse/nuxt) — useLocalStorage para persistencia de ajustes
  • vue3-emoji-picker

Calidad y Testing:

  • TypeScript, ESLint, Vitest, Vue Test Utils

🚀 Instalación y Desarrollo Local

Requisitos previos:

Pasos de instalación:

# 1. Instalar dependencias
pnpm install

# 2. Iniciar servidor de desarrollo
pnpm dev

About

Stroke Speech: An open-source PWA built with Nuxt 4 and the Web Speech API. It offers an offline augmentative and alternative communication (AAC) system using speech cards for stroke survivors.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors