Summary
The README screenshots and CLI demo GIFs were taken before Phase 7 shipped (Recommendations & Book Covers). They no longer show the current state of the app and should be retaken.
What needs to be captured
Web UI screenshots (docs/screenshots/)
| File |
What to show |
overview.png |
Overview with the new Recommendation Cards visible — ranked cards with embedded book cover thumbnails and evidence bullets at the top of the dashboard |
library.png |
Library list with book cover thumbnails in the left column of each row |
book-detail.png |
Book Detail header with the medium-sized cover image beside the title |
insights.png |
AI Insights feed (no cover changes here, but retake for visual freshness) |
activity.png |
Activity view (unchanged, but retake to match style of new shots) |
vocabulary.png |
Vocabulary view (unchanged, but retake to match style) |
chat.png / chat2.png |
Chat views (unchanged, but retake to match style) |
CLI demo (docs/demo/)
The existing konotes-cli.gif and konotes-chat-cli.gif are still accurate. No retake required unless you want to refresh them with current output formatting.
How to run the app with demo data
git clone https://github.com/texasbe2trill/KoNotes.git
cd KoNotes
pip install -e .
streamlit run app/app.py
Then click "Load demo data" in the sidebar to populate the app with the synthetic dataset — no real Kobo device needed.
Screenshot tips
- Window width: ~1400px for desktop-sized shots
- Use the built-in dark theme (Streamlit settings → Theme → Dark) to match the existing aesthetic
- Crop to the main content area, not the full browser window
- PNG preferred
Checklist
Summary
The README screenshots and CLI demo GIFs were taken before Phase 7 shipped (Recommendations & Book Covers). They no longer show the current state of the app and should be retaken.
What needs to be captured
Web UI screenshots (
docs/screenshots/)overview.pnglibrary.pngbook-detail.pnginsights.pngactivity.pngvocabulary.pngchat.png/chat2.pngCLI demo (
docs/demo/)The existing
konotes-cli.gifandkonotes-chat-cli.gifare still accurate. No retake required unless you want to refresh them with current output formatting.How to run the app with demo data
Then click "Load demo data" in the sidebar to populate the app with the synthetic dataset — no real Kobo device needed.
Screenshot tips
Checklist
overview.png— shows recommendation cards with book coverslibrary.png— shows cover thumbnails in book rowsbook-detail.png— shows cover in book headerinsights.pngactivity.pngvocabulary.pngchat.png/chat2.pngdocs/screenshots/