flutter_book_reader 1.5.13

A customizable Flutter reader widget for novels and ebooks: lazy chapter loading, paginated and continuous-scroll modes, themes, and pluggable data sources & progress storage.

Changelog

1.5.13

• Custom widget at the end of every chapter via chapterEndBuilder (chapter discussion, tip the author, next-chapter teaser…); pagination reserves room for it, so body text is never clipped.

1.5.12

• update: sorted dependencies and bumped flutter_lints to 6.

1.5.11

• Paragraph comment badges can now be hidden: a toggle in the reader menu, or config.setSegmentCommentsVisible(visible: …) from the host.
• Fix: a chapter that failed to load no longer retries endlessly.

1.5.10

• Fix: no more flicker at the end of a simulation page-curl.
• Performance: cheaper page-turn rendering across modes.

1.5.9

• Complete built-in labels for all 12 languages.
• Fix: localized and better-aligned auto page-turn entry.

1.5.8

• Locked chapters in scroll mode now show a content preview before the unlock block; ReaderLockInfo gains isScrollMode.

1.5.7

• Auto page-turn: timed flipping (paged) / smooth auto-scroll (vertical) via startAutoTurn / stopAutoTurn, with built-in speed & exit controls.

1.5.6

• Open at an exact in-chapter position via startCharOffset (paired with startChapter) — e.g. to resume from a bookmark.
• Fix: jumping to a bookmark / highlight / comment now lands on its exact page instead of falling back to the chapter's first page.

1.5.5

• Paid / locked chapters: mark chapters as locked via isChapterLocked. A locked chapter shows only its first page

1.5.4

• Performance: smoother text selection dragging and page turns — per-page layout invariants (comment-badge counts, indent width, block offsets) are now cached instead of recomputed each frame, most noticeable in heavily annotated books.

1.5.3

• Fix: opening the menu no longer shifts the page (system bars now overlay via edge-to-edge instead of resizing the reader), and tapping while the menu is open only closes it — never turns a page.
• Fix: a paragraph's comment badge now sits at the paragraph's true end — even when the paragraph spans pages — instead of at the bottom of the page.

1.5.2

• System status / navigation bars now show with the menu and hide when it closes; toggle via showSystemBarsWithMenu (default true).
• Optional footer battery indicator, host-fed via battery: ValueListenable<ReaderBatteryInfo?>; null hides it.

1.5.1

• Optional host-styled title page before chapter 1 via titlePageBuilder (a real, flippable page); null for none.

1.5.0

• New public BookReaderController for imperative control (paging, chapter jumps, currentPageText, read-along highlight, programmatic bookmarks).
• Paragraph comments via onSegmentCommentTap + commentsRefresh.
• Fix: no re-pagination when a bottom sheet / keyboard opens over the reader.

1.3.0

• Text selection with draggable handles, plus highlights (ReaderUnderlineStore) and comments (ReaderCommentStore), all collected in a Notes panel.
• Bubble toolbar actions (copy / comment / look-up / share) are now callbacks via onTextAction; only highlight stays internal.
  • ⚠️ Breaking: ReaderTextActionCallback now passes ReaderSelection instead of String, and ReaderTextAction adds comment.
• While the menu or selection bubble is open, a swipe only closes it (no accidental page turn).

1.2.0

• Built-in 12-language labels via ReaderLabels.forLanguageCode(code) (English fallback, still overridable).
• Redesigned menu and a draggable catalog with swipeable detail / contents / bookmarks tabs.
• Refined the six paper themes.

1.1.0

• New page-turn modes: simulation and cover, for five in total.
• Full-screen immersive reading (hides status & navigation bars); nav bar restored on exit.
• First-line indent now works with justified text.
• Reworked settings menu with a one-tap day/night toggle.

1.0.0

Initial release.

• Three page modes: horizontal paging (seamless, flicker-free chapter crossing), continuous vertical scroll (auto chapter loading), and no-animation.
• Paragraph-aware pagination via TextPainter; reader-owned first-line indent, paragraph spacing, and justification. Reading position preserved across font-size / line-height / system-text-scale changes.
• Lazy chapter loading with neighbor prefetch, bounded LRU cache, and loading / error-retry states.
• Pluggable BookSource (data) and ReaderProgressStore (progress) abstractions.
• Debounced progress saving with flush on app background.
• Six built-in themes with per-theme accent color; font size / line height / brightness overlay.
• Localizable UI strings via ReaderLabels; basic accessibility semantics.
• Callbacks: onChapterChanged, onPositionChanged, onClose.