TypeBridge
TypeBridge is an open-source, local-first browser text editor with optional Russian transliteration. Write plain text or type privet to get привет; transliteration changes writing systems, not meaning. No account, backend, analytics or text uploads. MIT licensed; see LICENSE.
Current capabilities
Implemented on main: live transliteration and literal input; selected-text conversion in both directions; custom mapping rules with JSON import/export; Find & Replace with optional regex; Undo/Redo saved with documents; document creation, naming and deletion; TXT/JSON backup and import; Focus Mode; resizing; word/character counts and saved System/Light/Dark appearance.
Documents and history use IndexedDB. Settings and custom rules use localStorage; tab selection and Find/Replace strings use sessionStorage. Revision checks preserve conflicting tab edits as copies. With autosave enabled, each edit also writes unsaved text to a temporary emergency journal in localStorage (text and title, visible to other tabs), and on pagehide or beforeunload the tab attempts a reload snapshot in its sessionStorage (text, title and Undo history). These copies are cleared once the edit is saved; clearing IndexedDB alone does not remove them. These are browser-local copies, subject to quota, eviction and browser lifecycle limits: export important work. See architecture and settings lifetimes.
After a successful online service-worker installation, the production build can reopen offline on the same origin and browser profile. Offline support does not guarantee storage durability. A new independent tab currently opens the latest saved document; reload uses the tab's selected document when available. Older blank-tab requirements are historical, not the current behavior.
GitHub Pages deployment is enabled for main. Successful Actions deployment is not proof of every production interaction; record browser/device checks separately. PRs are not automatically hosted previews. See preview and deployment notes.
Workspace
The top bar holds the editable document title, ▾ Documents menu, compact save state, Latin/Кириллица typing switch, Focus and Settings. The editing toolbar offers Undo/Redo, selected-text conversion, Find and Copy; its ⋯ menu contains Go to line and Clear text. Find/Replace and Go to line open on demand. Settings groups the shortcut, mapping rules, Autosave and Tab indents.
Focus mode keeps the same title, document menu, save state and typing switch above the editor, plus Exit focus. On phones controls wrap to fit; larger text may need extra rows. The detailed status line under the editor retains storage and conflict warnings. See the current UI.
Development
Use Node.js 22.13+ in the Node 22 line, or Node 24+, and npm. Run npm ci, then npm run dev and open the URL Vite prints.
See CONTRIBUTING.md for the issue, review and merge workflow. Before a PR, run npm run lint, npm run format:check (run npm run format to fix HTML/CSS formatting), npm run typecheck, npm run test:unit, and npm run build. Install browsers with npx playwright install chromium firefox webkit (Linux may need --with-deps), then run npm run test:e2e. Playwright tests the production build at the site root / in Chromium, Firefox and WebKit. See editor behavior and manual test limits; Linux WebKit is not real Safari/iOS testing.
Requirements and remaining work
The PRD includes historical design intent; the UI document describes the current workspace. Dual panels, portable document links, rich/Markdown preview, retained version snapshots and broader editing commands are not implemented just because they appear there. Current UX work and the audit fixes are tracked in issues; check PR merge and production verification separately.
