[Feature]: Desktop app: books reader
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 20/100
- Issue type
- Feature
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- rust, typescript
- Domain
- desktop, full-stack
Research direction
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.
Written by the indexing model from the issue text.
Description
[!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.tsto Rust with its tests (books.test.ts): the content model (/api/books/{id}/contentJSON, with style flagsBOLD,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.
- Dominant language
- TypeScript
- Stars
- 4
- Forks
- 1
- Avg merge
- 4h 49m
- Merged PRs (30d)
- 5
Getting set up
- Ships a Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from tinystream-dev/tinystream
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
tinystream-dev/tinystream#132 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
tinystream-dev/tinystream#131 ·
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 88/100
tinystream-dev/tinystream#129 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
tinystream-dev/tinystream#128 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
tinystream-dev/tinystream#124 ·
All issues in tinystream-dev/tinystream
Similar issues
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskOpen
Difficulty 1/5 Under an hour Newbie friendliness 86/100
sandbox-quantum/switch#2163 ·
Maintainers usually reply within 1 day
-
automated issue report
Difficulty 1/5 Under an hour Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
area/dashboard kind/bug QA/dev-automation
Difficulty 1/5 Under an hour Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
bug pydanty:is-working
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
pydantic/pydantic-ai#13939 ·
Maintainers usually reply within 1 day
-
self-host
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
funmusicplace/mirlo#2625 ·
Maintainers usually reply within 1 day