Language learning platform powered by long-form reading.
Read classic literature, build vocabulary with spaced repetition, track your progress.
Reader
- Kindle-like reading experience — themes (light/sepia/dark), fonts, fullscreen, keyboard shortcuts
- Text selection — dictionary lookup, translation (LibreTranslate), highlights
- TTS — Edge TTS, 200+ voices, speed control, two-layer cache (server + IndexedDB)
- Offline reading — PWA with IndexedDB caching, download manager, resume support
Vocabulary & SRS
- Save words while reading — sentence context, dictionary definition, translation
- Spaced repetition — 5 stages, 3 review modes (multiple choice, typed recall, context fill-in-the-blank)
- LLM-generated distractors & hints (Ollama)
Library
- 1,500+ public domain books (English + Ukrainian)
- User uploads — EPUB/PDF/FB2, auto-parsed with metadata enrichment
- Reading progress sync, bookmarks, highlights
- Reading stats — heatmap calendar, weekly charts, goals, 20 achievements
Blog
- Admin-authored posts with comments, likes, share buttons
- Per-language content (en/uk), threaded comments, SEO-optimized
Reviews & Social
- Star ratings (0–5, half-step), written reviews
- Threaded review comments, upvotes
- Reading mood tracking
SEO
- SSG prerendered pages (Puppeteer) — books, authors, genres, blog
- Sitemap XML auto-generation, IndexNow (Bing/Yandex)
- Article JSON-LD, FAQ schema markup
Admin Panel (textstack.dev)
- Book/author/genre CRUD, bulk import, chapter editor
- Blog management — create, edit, publish, cover upload
- SEO crawl, SSG rebuild, ingestion queue, settings
| Layer | Technology |
|---|---|
| API | ASP.NET Core (.NET 10), Minimal APIs |
| Database | PostgreSQL 16, EF Core (snake_case) |
| Search | PostgreSQL FTS / Meilisearch (swappable) |
| Frontend | React 18, Vite, CSS Variables |
| Admin | React (separate app), JWT auth |
| Mobile | React Native (Expo) |
| TTS | Edge TTS (WebSocket, no API key) |
| Translation | LibreTranslate (self-hosted) |
| LLM | Ollama (gemma3:4b) — metadata, vocab distractors |
| SSG | Puppeteer prerender, nginx serves static first |
| Telemetry | OpenTelemetry → .NET Aspire Dashboard |
| Infra | Docker Compose, Cloudflare Tunnel, nginx |
cp .env.example .env # Edit with real values
docker compose up --build # Start all services| Service | URL |
|---|---|
| Web | http://localhost:5173 |
| API | http://localhost:8080 |
| API Docs | http://localhost:8080/scalar/v1 |
| Admin | http://localhost:81 |
| Aspire | http://localhost:18888 |
backend/src/
Api/ Minimal API, endpoints, middleware
Worker/ Book ingestion, metadata generation
Domain/ Entities, enums
Infrastructure/ EF Core, migrations, storage
Application/ Business logic, interfaces
Contracts/ Shared DTOs (request/response)
Search/ FTS providers (Postgres, Meilisearch)
Extraction/ EPUB/PDF/FB2 parsers
Tts/ Edge TTS client + caching service
apps/
web/ Public site (React + Vite)
admin/ Admin panel (React + Vite)
mobile/ Mobile app (React Native + Expo)
Architecture: API → Application → Domain ← Infrastructure
# Docker
make up / down / restart / logs / status
make build # docker compose up -d --build
make deploy # Full deploy (pull, build, restart)
# SSG
make rebuild-ssg # Regenerate SEO pages
make clean-ssg # Remove dist/ssg*
# Database
make backup # Backup to ~/backups/textstack/
make restore FILE=path.gz # Restore from backup
# Search
make reindex-search # Rebuild search indexes
# Tests
dotnet test # All backend tests
pnpm -C apps/web test # Frontend unit tests
pnpm -C apps/web test:e2e # Playwright E2EInternet → Cloudflare (DNS + SSL) → Cloudflare Tunnel → nginx
├─ textstack.app → SSG static + /api/ proxy to :8080
└─ textstack.dev → admin panel (:81)
SSG auto-rebuilds every 24h. Manual rebuild via admin panel or make rebuild-ssg.
See docs/ for architecture decisions, deployment guides, and API reference.