Skip to content

SubchiBeats/bol-sakhi-communication-board

Repository files navigation

🗣️ Bol Sakhi · ਬੋਲ ਸਖੀ

A bilingual, picture-based communication board for stroke recovery.

Large one-tap requests with instant English + Punjabi text-to-speech, laid out for one-handed (left-hand) use on a phone or tablet at the bedside.

▶ Open the board

React 19 Vite PWA Web Speech API License: MIT


Why

After a stroke, speaking and fine motor control can be hard, and a familiar first language often comes back before a second one does. Bol Sakhi gives a person a fast, dignified way to make everyday needs understood — one large button, one clear spoken phrase — in both English and Punjabi, with the most urgent controls always on screen.

It is built for real bedside and nursing-home use: big touch targets, no clutter, and nothing to read or set up before the first tap.

Features

Speech & language

  • English and Punjabi labels, with the chosen phrase spoken aloud on tap
  • Native Punjabi speech when the device has it, plus a Hindi-compatible pronunciation fallback that stops devices from spelling out Gurmukhi letter names
  • Built-in voice test and adjustable speech speed

Everyday requests

  • Large picture buttons sized for shared and nursing-home use
  • Favorite shortcuts for raising/lowering the bed and adjusting a hearing aid
  • Always-visible Nurse, Stop, Yes, and No controls
  • Pain location and severity chooser
  • Dedicated communication and feelings phrases
  • TV on/off, volume, and channel requests
  • Recent-request history, so a message that was missed can be replayed
  • Refreshable Gurbani thoughts and a bilingual “We love Kuldip Kaur” message

For caregivers

  • Editor to add, hide, favorite, reorder, and reword requests
  • Export / import to share a customized board across family devices
  • A quick communication guide for rotating caregivers and staff
  • Per-device saved settings, with automatic upgrades to the default request set

App & device

  • Installable PWA with an offline app shell
  • Optional keep-screen-awake mode and iPhone/iPad Home Screen guidance

Built with

React 19 + Vite, with a small, framework-light surface so the board stays fast and predictable. Speech is the browser's native Web Speech API — no servers, no accounts, no third-party requests. State and customizations live in the device's localStorage.

Run locally

npm install
npm run dev

Build & deploy

npm run build      # production build to dist/
npm run preview    # serve the build locally

The included GitHub Actions workflow (.github/workflows/deploy-pages.yml) builds and deploys to GitHub Pages on every push to main. In the repository settings, set Pages → Source to GitHub Actions.

Tests

npm test     # Vitest — speech fallbacks and request-data integrity
npm run lint # ESLint

Privacy & safety

  • No accounts, no analytics, no network calls. Everything runs on the device.
  • Customizations are saved only in that browser/device, so apply the same changes on each family device as needed.
  • Punjabi speech quality depends on whether the device has a Punjabi voice installed.
  • This is a communication aid — it does not replace medical assessment, monitoring, or emergency systems.

License

MIT © Sahib Singh — see LICENSE.

About

Accessible, bilingual (English + Punjabi) picture communication board with instant text-to-speech — built for stroke recovery and one-handed use. Installable offline PWA.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors