[Feature]: Desktop app: books reader

Ouverte
#94 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
20/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
rust, typescript
Domaine
desktop, full-stack

Piste de recherche

Read the epic #80 and its prerequisites #82 and #83, then use the web reader files under web/src/books/ and the routes/book.$id.tsx and routes/read.$id.tsx routes as the specification. Start by porting packages/shared/src/books.ts and its books.test.ts tests to Rust. Done means long EPUB and FB2 books read like they do on the web, positions sync to the same sentence across window sizes, and quotes sync between web and desktop.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

enhancement

[!NOTE]
This issue was written by Claude (Claude Opus 5.5) from a planning session with @PhrolovaMoe. Part of #80, builds on #82 and #83. Read the epic first.

Area

Desktop app

Problem

The web has a novel reader with positions shared across devices and quotes (highlights stored as clips). It's part of parity.

Proposed solution

The web is the spec: web/src/books/ (Library.tsx, Reader.tsx, components.tsx, focus.ts, quotes.tsx), routes/book.$id.tsx, routes/read.$id.tsx.

  • Port packages/shared/src/books.ts to Rust with its tests (books.test.ts): the content model (/api/books/{id}/content JSON, with style flags BOLD, ITALIC… as bits) and positions counted in characters of text, so the same position lands on the same sentence on web, Android and desktop, at any size.
  • Layout and text with iced's text stack (cosmic-text), in Geist and whatever font choices the web reader offers. Images through /api/books/{id}/files/{*name}, covers through /api/books/{id}/cover.
  • Every reading mode and setting the web reader has (paging/scrolling, sizes, margins, themes within the app's scheme), the focus behaviour of focus.ts, and keyboard navigation.
  • Progress: the same mutations and cadence as the web, so switching devices continues where you were.
  • Quotes: selecting text and saving a quote (a highlight stored as a clip), showing existing highlights, the quotes list, as on web.
  • The book's details page (book.$id): metadata, cover, continue reading.
Done when

A long EPUB and an FB2 read the same as on web. Positions round-trip between web and app to the same sentence at different window sizes, and quotes made in either show up in both.

Langage dominant
TypeScript
Étoiles
4
Forks
1
Merge moyen
4 h 49 min
PR mergées (30 j)
5

Préparer son environnement

  • Fournit un Dockerfile ou un fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de tinystream-dev/tinystream

Toutes les issues de tinystream-dev/tinystream

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.