Update 3

CHANGELOG.md

@@ -0,0 +1,49 @@
+# BookStax – Development Changelog
+
+## Session 1
+
+### Architecture & Foundation
+- Full app architecture planned and implemented from scratch
+- Target: iOS 26.2, Xcode 26, Swift 6, `SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor`
+- Models: `BookStackError`, all API DTOs (`ShelfDTO`, `BookDTO`, `ChapterDTO`, `PageDTO`, etc.), SwiftData cache models
+- Services: `KeychainService` (actor), `ConnectivityMonitor` (@Observable), `BookStackAPI` (actor), `SyncService`
+- ViewModels: `OnboardingViewModel`, `LibraryViewModel`, `SearchViewModel`, `PageEditorViewModel`
+- Views: Full onboarding flow, library hierarchy, page reader (WebPage/WebView iOS 26), editor, search, settings, main tab view
+- Localisation: English, German, Spanish (`Localizable.strings`)
+- SwiftData model container, onboarding gate, Keychain credential loading wired in `bookstaxApp.swift`
+
+---
+
+## Session 2
+
+### Bug Fixes
+- **BookStackAPI filter syntax**: Fixed `book_id=X` → `filter[book_id]=X` for chapters and pages endpoints (BookStack API requirement)
+- **Color picker in Settings not responding**: Added `.buttonStyle(.plain)` to swatch buttons inside `Form` (SwiftUI list button style conflict)
+
+### Localisation
+- **Search section fully translated**: Replaced all hardcoded English strings in `SearchView.swift` with `L()` keys
+- **`ContentType.displayName`**: Changed from hardcoded English to `NSLocalizedString` (required because `nonisolated` structs can't call `@MainActor`-isolated `L()`)
+- New localisation keys added to en/de/es: `search.loading`, `search.empty.title`, `search.empty.message`, `search.filter.all`, `search.type.page/book/chapter/shelf`
+
+### Breadcrumb Navigation (Library)
+- Added `BookInShelf` wrapper struct (Hashable) to carry shelf context through `NavigationStack`
+- Added `Crumb` struct and `BreadcrumbBar` view (scrollable, tappable ancestor crumbs)
+- Breadcrumbs embedded as first `Section` in `List` (prevents large title collapse that occurred with `.safeAreaInset`)
+- `BooksInShelfView`: shows Library → Shelf crumbs, dismiss action on Library crumb
+- `BookDetailView`: shows Library → Shelf → Book crumbs, new `shelfName: String?` parameter
+- New `navigationDestination(for: BookInShelf.self)` in `LibraryView`
+
+---
+
+## Session 3
+
+### App Icon
+- Created three 1024×1024 app icon variants (light, dark, tinted) using provided artwork
+- **Light** (`AppIcon.png`): isometric purple BookStax books on white background
+- **Dark** (`AppIcon-dark.png`): same books on dark navy background (user-provided AI-generated image)
+- **Tinted** (`AppIcon-tinted.png`): greyscale version of dark icon for iOS tinted icon mode
+- `Contents.json` references all three variants with correct `luminosity` appearance entries
+- Icon files also saved as standalone copies in `bookstax/bookstax/`
+
+### Build Fix
+- Fixed stray `t` character at top of `PageEditorView.swift` causing compile errors (`timport SwiftUI` → `import SwiftUI`)