How mozzo1000/booklogr works
BookLogr is a self-hosted personal-library web app. Users authenticate, search or manually add books, organize them by reading status, track progress and ratings, and optionally publish a profile; notes, custom fields, and data export extend that workflow. The React app calls a Flask API whose route handlers operate on SQLAlchemy models. The README documents Mastodon sharing and multiple export formats; task execution is visible in the sampled API excerpt. Frontend links for several documented features are not shown, so those connections rely on README evidence.
Main entry points: app.py Flask app and routing · models.py Library data models · books.py Book endpoints · tasks.py Background tasks
Components 22
Web application
- App routing
web/src/App.jsx
Library workflows
- Library and book views
web/src/pages/Library.jsx - Book API client
web/src/services/books.service.jsx - Book search hook
web/src/hooks/useSearch.js - Notes and quotes
api/routes/notes.py - Custom book fields
api/routes/fields.py
Accounts and profiles
- Authentication client
web/src/services/auth.service.jsx - Profile page
web/src/pages/Profile.jsx
API services
- Book endpoints
api/routes/books.py - OpenLibrary lookup
api/book_provider.py - Auth endpoints
api/auth/auth_route.py - User endpoints
api/auth/user_route.py - Public profiles
api/routes/profiles.py - User settings
api/routes/settings.py - Import and export files
api/routes/files.py - Background tasks
api/routes/tasks.py - Flask app and routing
api/app.py
Persistence and tasks
- Library data models
api/models.py - Account data models
api/auth/models.py - SQL database
Other components
- Library user
- Mastodon
Connections 29
- Library user → App routing: uses
web/src/App.jsx - App routing → Library and book views: routes to
web/src/App.jsx - Library and book views → Book API client: requests books
- Book search hook → Book API client: queries
web/src/hooks/useSearch.js - Book API client → Book endpoints: calls API
web/src/services/books.service.jsx - Book endpoints → OpenLibrary lookup: looks up books
api/routes/books.py - Book endpoints → Library data models: reads and writes
api/routes/books.py - Notes and quotes → Library data models: reads and writes
api/routes/notes.py - Custom book fields → Library data models: reads and writes
api/routes/fields.py - Authentication client → Auth endpoints: calls API
web/src/services/auth.service.jsx - Auth endpoints → Account data models: uses
api/auth/auth_route.py - User endpoints → Account data models: uses
api/auth/user_route.py - Profile page → Public profiles: loads profile
- Public profiles → Library data models: reads profile data
api/routes/profiles.py - User settings → Library data models: reads and writes
api/routes/settings.py - Import and export files → Library data models: imports and exports
api/routes/files.py - Background tasks → Library data models: records task
api/routes/tasks.py - Background tasks → Mastodon: shares progress
- Flask app and routing → Book endpoints: registers
api/app.py - Flask app and routing → Public profiles: registers
api/app.py - Flask app and routing → Auth endpoints: registers
api/app.py - Flask app and routing → User endpoints: registers
api/app.py - Flask app and routing → Notes and quotes: registers
api/app.py - Flask app and routing → Background tasks: registers
api/app.py - Flask app and routing → Import and export files: registers
api/app.py - Flask app and routing → User settings: registers
api/app.py - Flask app and routing → Custom book fields: registers
api/app.py - Library data models → SQL database: persists data
api/models.py - Account data models → SQL database: persists accounts
api/auth/models.py