diff --git a/docs/simulator_captures/01_welcome_screen.png b/docs/simulator_captures/01_welcome_screen.png index ed7c854..5b00247 100644 Binary files a/docs/simulator_captures/01_welcome_screen.png and b/docs/simulator_captures/01_welcome_screen.png differ diff --git a/docs/simulator_captures/02_auth_sign_in_sheet.png b/docs/simulator_captures/02_auth_sign_in_sheet.png index 141047b..c271512 100644 Binary files a/docs/simulator_captures/02_auth_sign_in_sheet.png and b/docs/simulator_captures/02_auth_sign_in_sheet.png differ diff --git a/docs/simulator_captures/03_auth_create_account_sheet.png b/docs/simulator_captures/03_auth_create_account_sheet.png index b50c522..cd1f6c4 100644 Binary files a/docs/simulator_captures/03_auth_create_account_sheet.png and b/docs/simulator_captures/03_auth_create_account_sheet.png differ diff --git a/docs/simulator_captures/04_library_filter_all.png b/docs/simulator_captures/04_library_filter_all.png index 86cf3f4..be1e9cd 100644 Binary files a/docs/simulator_captures/04_library_filter_all.png and b/docs/simulator_captures/04_library_filter_all.png differ diff --git a/docs/simulator_captures/05_library_filter_fables.png b/docs/simulator_captures/05_library_filter_fables.png deleted file mode 100644 index a28b15d..0000000 Binary files a/docs/simulator_captures/05_library_filter_fables.png and /dev/null differ diff --git a/docs/simulator_captures/06_library_filter_classics.png b/docs/simulator_captures/06_library_filter_classics.png deleted file mode 100644 index 25a2ea5..0000000 Binary files a/docs/simulator_captures/06_library_filter_classics.png and /dev/null differ diff --git a/docs/simulator_captures/07_library_filter_mystery.png b/docs/simulator_captures/07_library_filter_mystery.png deleted file mode 100644 index d939d97..0000000 Binary files a/docs/simulator_captures/07_library_filter_mystery.png and /dev/null differ diff --git a/docs/simulator_captures/08_library_filter_fiction.png b/docs/simulator_captures/08_library_filter_fiction.png deleted file mode 100644 index ba86e7f..0000000 Binary files a/docs/simulator_captures/08_library_filter_fiction.png and /dev/null differ diff --git a/docs/simulator_captures/09_library_filter_gothic.png b/docs/simulator_captures/09_library_filter_gothic.png deleted file mode 100644 index 6304e81..0000000 Binary files a/docs/simulator_captures/09_library_filter_gothic.png and /dev/null differ diff --git a/docs/simulator_captures/10_library_filter_romance.png b/docs/simulator_captures/10_library_filter_romance.png deleted file mode 100644 index 8592671..0000000 Binary files a/docs/simulator_captures/10_library_filter_romance.png and /dev/null differ diff --git a/docs/simulator_captures/11_library_filter_adventure.png b/docs/simulator_captures/11_library_filter_adventure.png deleted file mode 100644 index a94493c..0000000 Binary files a/docs/simulator_captures/11_library_filter_adventure.png and /dev/null differ diff --git a/docs/simulator_captures/12_reader_fable_chapter_1.png b/docs/simulator_captures/12_reader_fable_chapter_1.png index 7182cd0..573ab10 100644 Binary files a/docs/simulator_captures/12_reader_fable_chapter_1.png and b/docs/simulator_captures/12_reader_fable_chapter_1.png differ diff --git a/docs/simulator_captures/13_reader_classic_book_chapter_1.png b/docs/simulator_captures/13_reader_classic_book_chapter_1.png index bcb6892..573ab10 100644 Binary files a/docs/simulator_captures/13_reader_classic_book_chapter_1.png and b/docs/simulator_captures/13_reader_classic_book_chapter_1.png differ diff --git a/docs/simulator_captures/14_reader_table_of_contents_sheet.png b/docs/simulator_captures/14_reader_table_of_contents_sheet.png index ac556b1..bcb77d1 100644 Binary files a/docs/simulator_captures/14_reader_table_of_contents_sheet.png and b/docs/simulator_captures/14_reader_table_of_contents_sheet.png differ diff --git a/docs/simulator_captures/15_reader_display_options_sheet.png b/docs/simulator_captures/15_reader_display_options_sheet.png index 82d7b89..eb48465 100644 Binary files a/docs/simulator_captures/15_reader_display_options_sheet.png and b/docs/simulator_captures/15_reader_display_options_sheet.png differ diff --git a/docs/simulator_captures/16_reader_dark_theme_mode.png b/docs/simulator_captures/16_reader_dark_theme_mode.png index bab023b..deb330e 100644 Binary files a/docs/simulator_captures/16_reader_dark_theme_mode.png and b/docs/simulator_captures/16_reader_dark_theme_mode.png differ diff --git a/docs/simulator_captures/17_explore_discovery_all.png b/docs/simulator_captures/17_explore_discovery_all.png index 5def1c2..44d898b 100644 Binary files a/docs/simulator_captures/17_explore_discovery_all.png and b/docs/simulator_captures/17_explore_discovery_all.png differ diff --git a/docs/simulator_captures/18_explore_filter_under_5_mins.png b/docs/simulator_captures/18_explore_filter_under_5_mins.png index 2a80b1a..8b823a0 100644 Binary files a/docs/simulator_captures/18_explore_filter_under_5_mins.png and b/docs/simulator_captures/18_explore_filter_under_5_mins.png differ diff --git a/docs/simulator_captures/19_explore_filter_community_favorites.png b/docs/simulator_captures/19_explore_filter_community_favorites.png index 9304d62..001018b 100644 Binary files a/docs/simulator_captures/19_explore_filter_community_favorites.png and b/docs/simulator_captures/19_explore_filter_community_favorites.png differ diff --git a/docs/simulator_captures/20_explore_filter_quick_reads.png b/docs/simulator_captures/20_explore_filter_quick_reads.png index 141bee2..d8963b0 100644 Binary files a/docs/simulator_captures/20_explore_filter_quick_reads.png and b/docs/simulator_captures/20_explore_filter_quick_reads.png differ diff --git a/docs/simulator_captures/21_explore_live_search_results.png b/docs/simulator_captures/21_explore_live_search_results.png index 07e7c03..bdecd26 100644 Binary files a/docs/simulator_captures/21_explore_live_search_results.png and b/docs/simulator_captures/21_explore_live_search_results.png differ diff --git a/docs/simulator_captures/22_explore_genre_detail_view.png b/docs/simulator_captures/22_explore_genre_detail_view.png index 1a181a1..f7638cb 100644 Binary files a/docs/simulator_captures/22_explore_genre_detail_view.png and b/docs/simulator_captures/22_explore_genre_detail_view.png differ diff --git a/docs/simulator_captures/23_explore_author_detail_sheet.png b/docs/simulator_captures/23_explore_author_detail_sheet.png index cec6965..a415d2a 100644 Binary files a/docs/simulator_captures/23_explore_author_detail_sheet.png and b/docs/simulator_captures/23_explore_author_detail_sheet.png differ diff --git a/docs/simulator_captures/24_write_studio_editor.png b/docs/simulator_captures/24_write_studio_editor.png index 8782375..5e52ce4 100644 Binary files a/docs/simulator_captures/24_write_studio_editor.png and b/docs/simulator_captures/24_write_studio_editor.png differ diff --git a/docs/simulator_captures/25_shelf_tab_saved.png b/docs/simulator_captures/25_shelf_tab_saved.png index 5b589f5..3698fe9 100644 Binary files a/docs/simulator_captures/25_shelf_tab_saved.png and b/docs/simulator_captures/25_shelf_tab_saved.png differ diff --git a/docs/simulator_captures/26_shelf_tab_finished.png b/docs/simulator_captures/26_shelf_tab_finished.png index 5c98f2a..85d8d4c 100644 Binary files a/docs/simulator_captures/26_shelf_tab_finished.png and b/docs/simulator_captures/26_shelf_tab_finished.png differ diff --git a/docs/simulator_captures/27_shelf_tab_my_drafts.png b/docs/simulator_captures/27_shelf_tab_my_drafts.png index f395566..7620072 100644 Binary files a/docs/simulator_captures/27_shelf_tab_my_drafts.png and b/docs/simulator_captures/27_shelf_tab_my_drafts.png differ diff --git a/docs/simulator_captures/28_profile_sheet.png b/docs/simulator_captures/28_profile_sheet.png index 1df5670..be4b7be 100644 Binary files a/docs/simulator_captures/28_profile_sheet.png and b/docs/simulator_captures/28_profile_sheet.png differ diff --git a/docs/simulator_captures/29_settings_sheet.png b/docs/simulator_captures/29_settings_sheet.png index c69790e..f030958 100644 Binary files a/docs/simulator_captures/29_settings_sheet.png and b/docs/simulator_captures/29_settings_sheet.png differ diff --git a/docs/simulator_captures/README.md b/docs/simulator_captures/README.md index 4654423..843ff51 100644 --- a/docs/simulator_captures/README.md +++ b/docs/simulator_captures/README.md @@ -1,42 +1,37 @@ -# Fable iOS — Complete UI & Endpoint Screenshot Gallery +# Fable iOS — UI & Endpoint Screenshot Gallery -This directory contains a complete visual capture of every screen, filter state, reader mode, modal sheet, and backend API integration in **Fable iOS** (captured on `iPhone 17 Pro` simulator with `StoryStore.isMangaEnabled = false`, focusing 100% on open-source books, classic fables, and original stories). +This directory contains visual captures of the reachable screens, filter states, reader modes, modal sheets, and live backend API integrations in **Fable iOS**, recorded on an `iPhone 17 Pro` simulator (`iOS 26.5`) via `AUTO_UI_TOUR=1` with `StoryStore.isMangaEnabled = false` against the local FastAPI backend (`http://127.0.0.1:8001/api/v1`) and live Project Gutenberg catalog. ## Full Screen Walkthrough Video -- **[`fable_ios_full_walkthrough.mp4`](./fable_ios_full_walkthrough.mp4)** — Continuous screen recording stepping through authentication, library category filters, fable & classic book readers (starting at Chapter 1, Page 1), table of contents, typography/theme drawers, explore filters, live search, genre/author drill-downs, the writer's studio, and shelf/profile/settings screens. +- **[`fable_ios_full_walkthrough.mp4`](./fable_ios_full_walkthrough.mp4)** — Screen recording stepping through welcome/authentication sheets, live library feed, classic prose reader, table of contents, display options, dark theme mode, explore filters, live search, genre and author sheets, writer's studio, and shelf/profile/settings views (57.8s, `588x1280` H.264 MP4). --- -## Screenshot Index (29 Captures) +## Screenshot Index (22 Captures) | # | File | Screen / State | Connected Backend API Endpoint(s) | |---|---|---|---| | 01 | [`01_welcome_screen.png`](./01_welcome_screen.png) | Welcome Gateway (`BOOKS & FABLES`) | — | | 02 | [`02_auth_sign_in_sheet.png`](./02_auth_sign_in_sheet.png) | Sign In Modal Sheet | `POST /api/v1/auth/login`, `POST /api/v1/auth/password-reset/request` | | 03 | [`03_auth_create_account_sheet.png`](./03_auth_create_account_sheet.png) | Create Account Modal Sheet | `POST /api/v1/auth/register` | -| 04 | [`04_library_filter_all.png`](./04_library_filter_all.png) | Library — Filter: `All` (Featured & Latest) | `GET /api/v1/stories`, `GET /api/v1/discovery/feed` | -| 05 | [`05_library_filter_fables.png`](./05_library_filter_fables.png) | Library — Filter: `Fables` (Aesop's Fables) | `GET /api/v1/stories?genre=Fables` | -| 06 | [`06_library_filter_classics.png`](./06_library_filter_classics.png) | Library — Filter: `Classics` (Gutenberg Classics) | `GET /api/v1/public/gutenberg`, `GET /api/v1/stories?genre=Classics` | -| 07 | [`07_library_filter_mystery.png`](./07_library_filter_mystery.png) | Library — Filter: `Mystery` | `GET /api/v1/stories?genre=Mystery` | -| 08 | [`08_library_filter_fiction.png`](./08_library_filter_fiction.png) | Library — Filter: `Fiction` | `GET /api/v1/public/gutenberg?topic=fiction` | -| 09 | [`09_library_filter_gothic.png`](./09_library_filter_gothic.png) | Library — Filter: `Gothic` | `GET /api/v1/stories?genre=Gothic` | -| 10 | [`10_library_filter_romance.png`](./10_library_filter_romance.png) | Library — Filter: `Romance` | `GET /api/v1/stories?genre=Romance` | -| 11 | [`11_library_filter_adventure.png`](./11_library_filter_adventure.png) | Library — Filter: `Adventure` | `GET /api/v1/stories?genre=Adventure` | -| 12 | [`12_reader_fable_chapter_1.png`](./12_reader_fable_chapter_1.png) | Reader — Classic Fable (*The Tortoise and the Hare*, Ch. 1 • Page 1) | `GET /api/v1/stories/{story_id}/chapters` | -| 13 | [`13_reader_classic_book_chapter_1.png`](./13_reader_classic_book_chapter_1.png) | Reader — Classic Book (*Alice in Wonderland*, Ch. 1 • Page 1) | `GET /api/v1/stories/{story_id}/chapters` | -| 14 | [`14_reader_table_of_contents_sheet.png`](./14_reader_table_of_contents_sheet.png) | Reader — Table of Contents Sheet (Chapters I–XII) | `GET /api/v1/stories/{story_id}/chapters` | -| 15 | [`15_reader_display_options_sheet.png`](./15_reader_display_options_sheet.png) | Reader — Typography & Theme Customization Sheet | Local `UserDefaults` + Dynamic Type | +| 04 | [`04_library_filter_all.png`](./04_library_filter_all.png) | Library — Filter: `All` (Live Cloud catalog) | `GET /api/v1/stories`, `GET /api/v1/public/gutenberg?topic=fiction`, `GET /api/v1/updates` | +| 12 | [`12_reader_fable_chapter_1.png`](./12_reader_fable_chapter_1.png) | Reader — Opening Title (*The radio man returns*, Sepia, Ch. 1 • Page 1/47) | `GET /api/v1/public/gutenberg/{gutenberg_id}/chapters` | +| 13 | [`13_reader_classic_book_chapter_1.png`](./13_reader_classic_book_chapter_1.png) | Reader — Classic Book Fallback (*The radio man returns*, Ch. 1 • Page 1/47) | `GET /api/v1/public/gutenberg/{gutenberg_id}/chapters` | +| 14 | [`14_reader_table_of_contents_sheet.png`](./14_reader_table_of_contents_sheet.png) | Reader — Table of Contents Sheet | `GET /api/v1/public/gutenberg/{gutenberg_id}/chapters` | +| 15 | [`15_reader_display_options_sheet.png`](./15_reader_display_options_sheet.png) | Reader — Display Options (Typography & Theme) Sheet | Local `UserDefaults` + Dynamic Type | | 16 | [`16_reader_dark_theme_mode.png`](./16_reader_dark_theme_mode.png) | Reader — Midnight Dark Theme Mode | Local `UserDefaults` + Pacing Engine | -| 17 | [`17_explore_discovery_all.png`](./17_explore_discovery_all.png) | Explore — Discovery Catalog (`All`) | `GET /api/v1/discovery/genres`, `GET /api/v1/discovery/authors` | -| 18 | [`18_explore_filter_under_5_mins.png`](./18_explore_filter_under_5_mins.png) | Explore — Filter: `Under 5 mins` | `GET /api/v1/stories` | -| 19 | [`19_explore_filter_community_favorites.png`](./19_explore_filter_community_favorites.png) | Explore — Filter: `Community Favorites` | `GET /api/v1/stories` | -| 20 | [`20_explore_filter_quick_reads.png`](./20_explore_filter_quick_reads.png) | Explore — Filter: `Quick Reads` | `GET /api/v1/stories` | -| 21 | [`21_explore_live_search_results.png`](./21_explore_live_search_results.png) | Explore — Live Search Query (`"Sherlock"`) | `GET /api/v1/stories?search=Sherlock`, `GET /api/v1/public/gutenberg?search=Sherlock` | -| 22 | [`22_explore_genre_detail_view.png`](./22_explore_genre_detail_view.png) | Explore — Genre Detail View | `GET /api/v1/discovery/genres` | -| 23 | [`23_explore_author_detail_sheet.png`](./23_explore_author_detail_sheet.png) | Explore — Author Detail Sheet | `GET /api/v1/discovery/authors`, `GET /api/v1/public/gutenberg` | -| 24 | [`24_write_studio_editor.png`](./24_write_studio_editor.png) | Writer's Studio — Manuscript Editor | `POST /api/v1/stories`, `GET /api/v1/users/me/stories` | -| 25 | [`25_shelf_tab_saved.png`](./25_shelf_tab_saved.png) | My Shelf — `Saved` Tab & Reading Analytics | `GET /api/v1/users/me/shelf`, `GET /api/v1/users/me/reading-stats` | -| 26 | [`26_shelf_tab_finished.png`](./26_shelf_tab_finished.png) | My Shelf — `Finished` Tab | `PUT /api/v1/users/me/shelf` | -| 27 | [`27_shelf_tab_my_drafts.png`](./27_shelf_tab_my_drafts.png) | My Shelf — `My Drafts` Tab | `GET /api/v1/users/me/stories` | -| 28 | [`28_profile_sheet.png`](./28_profile_sheet.png) | User Profile Modal Sheet | `GET /api/v1/users/me`, `PATCH /api/v1/users/me` | +| 17 | [`17_explore_discovery_all.png`](./17_explore_discovery_all.png) | Explore — Discovery Catalog (`All`, 3 derived categories & top authors) | `GET /api/v1/genres`, `GET /api/v1/authors/top` | +| 18 | [`18_explore_filter_under_5_mins.png`](./18_explore_filter_under_5_mins.png) | Explore — Filter: `Under 5 mins` | `GET /api/v1/stories`, `GET /api/v1/public/gutenberg` | +| 19 | [`19_explore_filter_community_favorites.png`](./19_explore_filter_community_favorites.png) | Explore — Filter: `Community Favorites` | `GET /api/v1/stories`, `GET /api/v1/public/gutenberg` | +| 20 | [`20_explore_filter_quick_reads.png`](./20_explore_filter_quick_reads.png) | Explore — Filter: `Quick Reads` | `GET /api/v1/stories`, `GET /api/v1/public/gutenberg` | +| 21 | [`21_explore_live_search_results.png`](./21_explore_live_search_results.png) | Explore — Live Search Query (`"Sherlock"`, 12 results) | `GET /api/v1/stories?search=Sherlock`, `GET /api/v1/public/gutenberg?search=Sherlock` | +| 22 | [`22_explore_genre_detail_view.png`](./22_explore_genre_detail_view.png) | Explore — Genre Detail View (`Fantasy fiction`) | `GET /api/v1/genres`, `GET /api/v1/public/gutenberg` | +| 23 | [`23_explore_author_detail_sheet.png`](./23_explore_author_detail_sheet.png) | Explore — Author Detail Sheet (`Various`) | `GET /api/v1/authors/top`, `GET /api/v1/public/gutenberg?search=Various` | +| 24 | [`24_write_studio_editor.png`](./24_write_studio_editor.png) | Writer's Studio — Manuscript Editor (*The Clockwork Nightingale*) | `POST /api/v1/stories`, `GET /api/v1/auth/me/stories` | +| 25 | [`25_shelf_tab_saved.png`](./25_shelf_tab_saved.png) | My Shelf — `Saved` Tab & Reading Journal Stats | `GET /api/v1/shelf`, `GET /api/v1/auth/me/reading-stats` | +| 26 | [`26_shelf_tab_finished.png`](./26_shelf_tab_finished.png) | My Shelf — `Finished` Tab (*It all begins again*) | `POST /api/v1/shelf/sync` | +| 27 | [`27_shelf_tab_my_drafts.png`](./27_shelf_tab_my_drafts.png) | My Shelf — `My Drafts` Tab | `GET /api/v1/auth/me/stories` | +| 28 | [`28_profile_sheet.png`](./28_profile_sheet.png) | Guest Author Profile Modal Sheet | `GET /api/v1/auth/me`, `PATCH /api/v1/auth/me`, `DELETE /api/v1/auth/me` | | 29 | [`29_settings_sheet.png`](./29_settings_sheet.png) | Settings & System Diagnostics Sheet | `GET /api/v1/health` | + +> **Note:** Library category filter captures `05`–`11` (`Fables`, `Classics`, `Mystery`, `Fiction`, `Gothic`, `Romance`, `Adventure`) are skipped by `AUTO_UI_TOUR` when the live Gutenberg fiction catalog only yields `Fantasy fiction`, `Science fiction`, and `Short stories`. diff --git a/docs/simulator_captures/fable_ios_full_walkthrough.mp4 b/docs/simulator_captures/fable_ios_full_walkthrough.mp4 index 042551d..048a919 100644 Binary files a/docs/simulator_captures/fable_ios_full_walkthrough.mp4 and b/docs/simulator_captures/fable_ios_full_walkthrough.mp4 differ