A reader for developers who want to finish English technical books in their native language.
Tap any term → context-aware translation that knows the book's domain. Capped weekly SRS queue.
A modern replacement for Kindle Word Wise — built for technical books, not conversational language learning.
textstack.app · Why I built it · @Rexetdeus
I quit Designing Data-Intensive Applications three times before I built this.
⭐ Star the repo if you've ever abandoned a technical book mid-way — it's the strongest signal that this kind of tool is worth building.
I quit Designing Data-Intensive Applications three times. Not because it's hard — I understood most of what was on the page. The problem was the rest: unfamiliar terms that broke the flow. Eventual consistency. Attention mechanism. B-tree. Writing each one down to look up later works until you have 40 of them and you've lost the thread anyway.
Summarizing books away defeats the point. The only way to get deep understanding is to read them — but the friction has to go.
Tap any term → translation in your native language, aware of the book's
domain. Tap "attention" in an ML book and you get увага (механізм у
нейромережах) in Ukrainian or внимание (механизм в нейросетях) in
Russian — not the everyday meaning of the word. Explanation mode (no
translation) is also available for native English readers who want the
term clarified instead of translated. Powered by OpenAI gpt-5-mini,
swap-in friendly — any ILlmService impl works. 18+ target languages
supported, with Russian and Ukrainian as the focus during current
development.
Terms you don't recognize enter a capped weekly SRS queue — no infinite backlog, no guilt. Common words and the top 15K English words are filtered out; only technical vocabulary gets surfaced.
| Other tools | TextStack |
|---|---|
| Dictionary translation, word-by-word | Context-aware translation that knows the domain |
| Infinite SRS queue | Capped weekly — no review spiral |
| Generic content for casual learners | Built for dense technical books |
| Static Kindle Word Wise (2014) | LLM-powered (2026), 18+ target languages |
- textstack.app — sample chapters open without signup.
- Tap any word you don't recognize.
- That's the whole pitch.
Reader
- Kindle-like experience — themes (light/sepia/dark), fonts, fullscreen, keyboard shortcuts
- Text selection — contextual translation in 18+ languages (OpenAI
gpt-5-mini), explanation mode for English-only readers, dictionary fallback (Free Dictionary API), highlights - TTS — Edge TTS via direct WebSocket (200+ voices, 0.75×–2.0× speed, two- layer cache)
- Offline reading — PWA with IndexedDB caching, download manager
Vocabulary SRS
- Auto-added while reading — sentence context, definition, translation
- 5 stages (New → Recognition → Recall → Context → Mastered)
- Capped weekly queue + LLM-generated distractors and hints (Ollama
gemma4:e4b) - Review modes: multiple choice, classic flashcard
Library
- 1,500+ curated technical and classic books (starter corpus, self-hostable)
- Your own uploads — EPUB / PDF / FB2, auto-parsed with metadata enrichment
- Reading progress sync, bookmarks, highlights, reading stats
Mobile
- React Native (Expo), Android on Google Play
- Offline-first, same UX as web
Admin (textstack.dev)
- Book/author/genre CRUD, chapter editor, ingestion queue
- SSG rebuild, auto-publish, SEO backfill
| Layer | Technology |
|---|---|
| Backend | ASP.NET Core (.NET 10), Minimal APIs |
| Database | PostgreSQL 16 + EF Core (snake_case) |
| Search | PostgreSQL FTS |
| Web | React 19, Vite, pnpm |
| Mobile | React Native (Expo 55) |
| LLM | OpenAI gpt-5-mini (explanations + translation) + Ollama gemma4:e4b (distractors, local) |
| TTS | Edge TTS (WebSocket, no API key) |
| SSG | Puppeteer prerender, nginx serves static first |
| Telemetry | OpenTelemetry → Aspire Dashboard |
| Infra | Docker Compose, Cloudflare Tunnel, nginx |
Architecture: API → Application → Domain ← Infrastructure (modular
monolith). Worker runs ingestion + SRS scoring + SSG jobs.
git clone https://github.com/mrviduus/textstack
cd textstack
cp .env.example .env # edit with real values
docker compose up --build # ~3 min cold start| Service | URL |
|---|---|
| Web | http://localhost:5173 |
| API | http://localhost:8080 · Scalar docs |
| Admin | http://localhost:81 |
| Aspire (opt-in) | http://localhost:18888 — docker compose --profile observability up |
Prerequisites: Docker, .NET 10 SDK, Node.js 20+, pnpm.
# Local dev (no Docker)
dotnet run --project backend/src/Api
pnpm -C apps/web dev # http://localhost:5173
pnpm -C apps/admin dev # http://localhost:81
# Mobile
cd apps/mobile && npx expo start
# Tests
dotnet test # backend (unit + integration + extraction + search)
pnpm -C apps/web test # Vitest
pnpm -C apps/web test:e2e # Playwright
# Lint / format
dotnet format textstack.slnFull command reference: CLAUDE.md.
- Deployment — Cloudflare Tunnel + nginx + Docker
- Backup & Restore —
make backup, GHA daily dumps - Uptime Monitoring — UptimeRobot probes
- Incident Runbook — first-response for common outages
- infra/scripts — long-running pollers
- Now — Reader + Vocab SRS + offline PWA, 1,500+ books live
- Next — Android on Google Play, cap weekly SRS queue UX polish, curated AI-engineering corpus (DDIA, ML papers, 15–20 titles)
- Goal — one paying customer by October 2026
Progress tracked in PLAN-presale-8w.md.
Feedback, bug reports, and PRs welcome. See CONTRIBUTING.md (if it exists yet — otherwise open an issue and we'll sort it out).
Star the repo if this resonates. That's the only signal I have right now that I'm building the right thing.
Why AGPL? TextStack is built to be self-hosted and modified freely by individuals, teams, and small communities. AGPL ensures that if someone runs a modified version as a public service, those modifications are shared back. If your organization needs a non-AGPL license for a commercial fork or hosted product, see the commercial license note below.
GNU Affero General Public License v3.0 © 2026 Vasyl Vdovychenko.
TextStack is free and open-source software. You may use, modify, and self-host it freely for personal, internal, or community purposes. If you modify TextStack and run it as a network-accessible service, AGPL-3.0 requires you to publish your modifications under the same license.
Commercial license available for organizations that need to use TextStack without AGPL obligations (e.g. proprietary forks, hosted commercial services). Contact: mrviduus@gmail.com.
- Source code: AGPL-3.0
- Standard Ebooks corpus (included in seed data): CC0 / public domain
- Edge TTS: used under Microsoft's Edge Read Aloud terms
- Third-party deps: their respective licenses
A stack of books. A stack of text. Read through it.