Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 7 additions & 4 deletions .agents/skills/docs/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Regenerate key project docs from current product capabilities.
## Scope Rules

- Reflect current important features only.
- Treat docs as a durable product overview, not a summary of every recent change.
- Do not add minor UX polish, small fixes, or short-lived release-specific details unless they change the core product positioning.
- Keep product-facing language clear and concise.
- Avoid low-level technical implementation details.
- Keep messaging consistent across all three files.
Expand All @@ -37,10 +39,11 @@ Regenerate key project docs from current product capabilities.

1. Collect current user-visible features from codebase and project docs.
2. Decide the most important feature set to present.
3. Update all target files so wording and feature emphasis stay aligned.
4. Keep `README.md` as the most complete overview.
5. Keep `APP_STORE_DESCRIPTION.txt` concise and store-appropriate.
6. Keep `static/index.html` aligned with the same feature priorities.
3. Filter out low-signal recent changes that belong in changelogs rather than evergreen docs.
4. Update all target files so wording and feature emphasis stay aligned.
5. Keep `README.md` as the most complete overview.
6. Keep `APP_STORE_DESCRIPTION.txt` concise and store-appropriate.
7. Keep `static/index.html` aligned with the same feature priorities.

## Validation

Expand Down
28 changes: 12 additions & 16 deletions APP_STORE_CHANGELOG.txt
Original file line number Diff line number Diff line change
@@ -1,19 +1,15 @@
Reader Improvements
- DIVINA now offers cover-style page transitions on iPhone, iPad, Mac, and Apple TV, with steadier scroll and paged reading, better viewport alignment, improved RTL behavior, more consistent wide-page handling, more reliable preloading, and smoother recovery during fast navigation or app interruptions.
- Webtoon and scroll reading behave more predictably, including fixes for backward chapter jumps and page-position jumps after app background/foreground transitions.
- EPUB adds cover transitions on iPhone, iPad, and Mac, cover-style turns feel smoother thanks to better adjacent page preloading, and single-page content now supports swipe chapter navigation more reliably.
- Animated GIF and WebP pages now start immediately, stay smooth while you zoom or scroll, and behave more reliably when you reopen, revisit, or switch pages.
- Added a Show Page Shadow option for cleaner seamless spreads, and reader interactions are more consistent with improved tap-zone handling.
- EPUB on macOS now feels much closer to the iOS experience, with better settings, preview behavior, overlays, and keyboard shortcuts.
- EPUB reading has been improved across the app with better pagination, typography controls, dark theme behavior, link colors, and image rendering.
- Reader navigation is more reliable, including smoother DIVINA scrolling, better page position restoration, and more accurate next and previous book handling.
- Live Text interactions in the reader are more precise, reducing accidental page turns or missed control toggles.

Offline and Library Workflows
- EPUB downloads are now saved as a single file and extracted locally, making offline reading faster and more reliable.
- Offline sync and iOS background downloads now behave more predictably during reconnects and long-running transfers.
- Added an option to blur unread book and series covers to help avoid spoiler-heavy artwork.
Browsing and Library Updates
- Added a faster single-library picker mode for quicker filtering, including easier access on Apple TV.
- Book, series, and one-shot detail pages now support native share actions.
- Detail pages are easier to scan with collapsible metadata and link sections, plus clearer combined tag display.

Management and Platform Polish
- Added in-app media management tools for media analysis, missing posters, duplicate files, duplicate pages, and page-hash matches.
- Komga media error messages are clearer in the app, so unsupported files and analysis issues are easier to understand.
- macOS reader actions now live in the system menu bar for quicker keyboard-first control.

Live Activities
- Reader Live Activities can now be disabled, close immediately with the reader, and show reading progress or incognito status instead of a generic ON/OFF label.
Polish and Fixes
- Improved reader overlay animations and control behavior, especially for EPUB on iPhone, iPad, and Mac.
- Fixed several iPad layout issues related to closing the reader and restoring the main interface correctly.
- Refined end-of-book screens and close button styling for a cleaner, more consistent finish across platforms.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@

### Native Reading Experience

- DIVINA reader on iOS, macOS, and tvOS with LTR, RTL, vertical, Webtoon, spreads, zoom, customizable tap zones, page curl (iOS), cover-style page transitions on all platforms, optional page shadows, clearer page-turn animation controls, and steadier scroll/cover navigation with better RTL, wide-page, and interruption handling.
- DIVINA reader on iOS, macOS, and tvOS with LTR, RTL, vertical, Webtoon, spreads, zoom, customizable tap zones, page curl (iOS), cover-style page transitions on all platforms, optional page shadows, clearer page-turn animation controls, and steadier scroll and cover navigation with better RTL, wide-page, and interruption handling.
- EPUB reader on iOS/macOS with paged, scrolled, and cover layouts, custom font importing (`.ttf`/`.otf`), theme presets, multi-column reading, and nested table of contents.
- Animated GIF and WebP pages start immediately, stay smooth while you zoom or scroll, and remain reliable when reopening or revisiting pages.
- PDF reading on iOS/macOS with a native PDF reader or DIVINA mode, plus search, table of contents, page jump, configurable render quality tiers for offline preparation, and clearer progress feedback.
Expand Down
21 changes: 10 additions & 11 deletions static/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<title>KMReader · Native Komga Client for iOS, macOS & tvOS</title>
<meta
name="description"
content="KMReader is a native SwiftUI Komga client with DIVINA, EPUB, and PDF readers, reliable page loading, richer reader customization, offline downloads, media management, and multi-server support."
content="KMReader is a native SwiftUI Komga client with DIVINA, EPUB, and PDF readers, reliable offline downloads, advanced filtering, admin tools, and multi-server support."
/>
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
Expand All @@ -27,10 +27,9 @@
<h1>KMReader</h1>
<p class="tagline">
Read, download, browse, and manage your Komga library with
native readers, smooth animated page playback, richer
reader controls like page shadows and clearer animation
settings, more reliable page loading, reliable offline
sync, and practical Apple-platform extras like widgets,
native readers, smooth animated page playback, reliable
offline sync, advanced filtering, multi-server support,
and practical Apple-platform extras like widgets,
Spotlight, Dynamic Island updates, and keyboard-first
controls on iPhone, iPad, Mac, and Apple TV.
</p>
Expand Down Expand Up @@ -88,13 +87,13 @@ <h3>DIVINA, EPUB, and PDF</h3>
optional page shadows, clearer page-turn animation
controls, and steadier scroll reading with better
RTL, wide-page, and interruption handling.
EPUB on iOS/macOS adds custom fonts and paged,
EPUB on iOS/macOS adds custom fonts, paged,
scrolled, or cover layouts. Animated pages play
immediately, stay smooth while you zoom or
scroll, and remain reliable when you revisit
pages, while PDF on iOS/macOS offers a native
reader or DIVINA mode with search, TOC, and
configurable render quality.
immediately, stay smooth while you zoom or scroll,
and remain reliable when you revisit pages, while
PDF on iOS/macOS offers a native reader or DIVINA
mode with search, TOC, and configurable render
quality.
</p>
</article>
<article class="card">
Expand Down
Loading