> ## Documentation Index
> Fetch the complete documentation index at: https://braille.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BrailleBridge: Bilingual Braille Writing for the Classroom

> BrailleBridge lets blind students write with Braille chords while teachers receive real-time, readable digital text — no sighted writer needed.

BrailleBridge is a low-cost, bilingual digital Braille writing and classroom examination system built for blind and visually impaired students. You press familiar six-dot Braille chords on a physical mechanical keyboard, and an ESP32 microcontroller instantly translates each chord into readable English or Bangla text — delivering the result simultaneously to your own device over Bluetooth and to your teacher's browser-based console over USB Serial. No sighted writer, no privacy trade-offs, no expensive equipment.

> [card] [Introduction](https://braille.mintlify.site/introduction.md)
>
> Learn what BrailleBridge is, who it's built for, and the accessibility gap it closes in classrooms and examination halls.

> [card] [How It Works](https://braille.mintlify.site/how-it-works.md)
>
> Follow a Braille chord from keypress to readable text: GPIO reading, 6-bit bitmask encoding, dictionary lookup, and dual output.

> [card] [Quickstart](https://braille.mintlify.site/quickstart.md)
>
> Go from unboxing to your first typed character in four steps: power on, pair via Bluetooth, connect Teacher Software, and type.

> [card] [Teacher Software](https://braille.mintlify.site/teacher-software/overview.md)
>
> Explore the browser-based Teacher Software — real-time feeds, exam mode, timestamped exports, and multi-student monitoring.

## The three-step flow

Every character you type passes through the same simple pipeline — from your fingertips to your teacher's screen.

**1. Student types a chord**

You press one or more of the six dot keys simultaneously. The device collects all keys pressed within a 180 ms window so that fingers landing milliseconds apart are always read as a single, intended chord.

**2. ESP32 translates the chord**

The firmware encodes the pressed dots into a 6-bit bitmask, checks whether Shift is active, looks up the result in the active language dictionary (English or Bangla), and emits the translated character.

**3. Teacher sees readable text**

The translated character is sent over two independent channels at once: Bluetooth HID to your own phone, tablet, or PC (where a screen reader can read it aloud), and USB Serial to the Teacher Software running in the teacher's browser.

> [!NOTE]
>
> BrailleBridge costs under **\$15** per device to build from standard, locally replaceable parts. It supports both **English** (Grade 1 Braille, A–Z, numbers, and punctuation) and **Bangla** (following the Bharati Braille standard), switchable at any time by holding dots 4+5+6 for 500 ms.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.