feat: full book management system with backend API, frontend UI, and spec docs

- Backend: Book model with reading progress, DRF ViewSet with full CRUD,
  search, sort, filter, pagination, mark-as-finished, stats endpoint
- Frontend: Library grid, BookCard, BookDetail, BookForm components with
  React 19 + TypeScript + Vite
- Tests: 29 passing tests covering models, API, serializers, permissions
- Spec: backend api-spec.md and frontend component-spec.md in docs/

Closes crisleo-hermes/cloud-reader#3
This commit is contained in:
Marko (Hermes Implementer)
2026-05-26 04:35:13 +00:00
commit 84d8fed3f2
49 changed files with 4205 additions and 0 deletions
+577
View File
@@ -0,0 +1,577 @@
/* === Reset & Base === */
*,
*::before,
*::after {
box-sizing: border-box;
margin: 0;
padding: 0;
}
:root {
--color-bg: #0f1117;
--color-surface: #1a1d27;
--color-surface-hover: #242736;
--color-border: #2a2d3a;
--color-text: #e1e3ea;
--color-text-muted: #8b8fa3;
--color-primary: #6366f1;
--color-primary-hover: #4f46e5;
--color-success: #22c55e;
--color-danger: #ef4444;
--color-danger-hover: #dc2626;
--color-secondary: #374151;
--color-secondary-hover: #4b5563;
--radius: 8px;
--radius-lg: 12px;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
background-color: var(--color-bg);
color: var(--color-text);
line-height: 1.6;
-webkit-font-smoothing: antialiased;
}
/* === App Layout === */
.app {
min-height: 100vh;
display: flex;
flex-direction: column;
}
.app-header {
background-color: var(--color-surface);
border-bottom: 1px solid var(--color-border);
padding: 0 24px;
position: sticky;
top: 0;
z-index: 100;
}
.app-header-inner {
max-width: 1200px;
margin: 0 auto;
height: 56px;
display: flex;
align-items: center;
}
.app-logo {
display: flex;
align-items: center;
gap: 8px;
text-decoration: none;
color: var(--color-text);
font-weight: 700;
font-size: 1.125rem;
}
.logo-icon {
font-size: 1.5rem;
}
.app-main {
flex: 1;
max-width: 1200px;
width: 100%;
margin: 0 auto;
padding: 24px;
}
/* === Library === */
.library-header {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: 20px;
}
.library-header h1 {
font-size: 1.75rem;
font-weight: 700;
}
/* === Stats === */
.library-stats {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
gap: 12px;
margin-bottom: 24px;
}
.stat-card {
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius);
padding: 16px;
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
}
.stat-value {
font-size: 1.5rem;
font-weight: 700;
}
.stat-label {
font-size: 0.8rem;
color: var(--color-text-muted);
text-transform: uppercase;
letter-spacing: 0.05em;
}
/* === Controls === */
.library-controls {
display: flex;
gap: 12px;
margin-bottom: 20px;
flex-wrap: wrap;
}
.search-input {
flex: 1;
min-width: 200px;
padding: 10px 14px;
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius);
color: var(--color-text);
font-size: 0.9rem;
}
.search-input:focus {
outline: none;
border-color: var(--color-primary);
}
.sort-select,
.filter-select {
padding: 10px 14px;
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius);
color: var(--color-text);
font-size: 0.9rem;
cursor: pointer;
}
/* === Books Grid === */
.books-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
gap: 16px;
}
.book-card {
display: flex;
gap: 16px;
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius-lg);
padding: 16px;
cursor: pointer;
transition: background-color 0.15s, border-color 0.15s, transform 0.15s;
}
.book-card:hover {
background: var(--color-surface-hover);
border-color: var(--color-primary);
transform: translateY(-2px);
}
.book-card-cover {
flex-shrink: 0;
width: 80px;
height: 120px;
border-radius: 6px;
overflow: hidden;
}
.book-card-cover img {
width: 100%;
height: 100%;
object-fit: cover;
}
.book-card-placeholder {
width: 100%;
height: 100%;
background: linear-gradient(135deg, var(--color-primary), #8b5cf6);
display: flex;
align-items: center;
justify-content: center;
font-size: 1.75rem;
font-weight: 700;
color: white;
}
.book-card-placeholder.large {
width: 180px;
height: 260px;
font-size: 3rem;
}
.book-card-info {
flex: 1;
min-width: 0;
display: flex;
flex-direction: column;
gap: 4px;
}
.book-card-title {
font-size: 1rem;
font-weight: 600;
line-height: 1.3;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
overflow: hidden;
}
.book-card-author {
font-size: 0.85rem;
color: var(--color-text-muted);
}
.book-card-genre {
display: inline-block;
font-size: 0.75rem;
padding: 2px 8px;
background: rgba(99, 102, 241, 0.15);
color: var(--color-primary);
border-radius: 12px;
align-self: flex-start;
}
.book-card-progress {
margin-top: auto;
}
/* === Progress Bar === */
.progress-bar {
width: 100%;
height: 6px;
background: var(--color-border);
border-radius: 3px;
overflow: hidden;
}
.progress-bar.large {
height: 10px;
border-radius: 5px;
}
.progress-fill {
height: 100%;
border-radius: 3px;
transition: width 0.3s ease;
}
.progress-text {
display: flex;
justify-content: space-between;
font-size: 0.75rem;
color: var(--color-text-muted);
margin-top: 4px;
}
/* === Buttons === */
.btn {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 8px 16px;
border: none;
border-radius: var(--radius);
font-size: 0.875rem;
font-weight: 500;
cursor: pointer;
transition: background-color 0.15s;
}
.btn:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.btn-primary {
background: var(--color-primary);
color: white;
}
.btn-primary:hover:not(:disabled) {
background: var(--color-primary-hover);
}
.btn-secondary {
background: var(--color-secondary);
color: var(--color-text);
}
.btn-secondary:hover:not(:disabled) {
background: var(--color-secondary-hover);
}
.btn-success {
background: var(--color-success);
color: white;
}
.btn-success:hover:not(:disabled) {
background: #16a34a;
}
.btn-danger {
background: var(--color-danger);
color: white;
}
.btn-danger:hover:not(:disabled) {
background: var(--color-danger-hover);
}
/* === Book Detail === */
.book-detail {
max-width: 800px;
}
.book-detail > .btn {
margin-bottom: 24px;
}
.book-detail-header {
display: flex;
gap: 32px;
margin-bottom: 32px;
}
.book-detail-cover {
flex-shrink: 0;
width: 180px;
height: 260px;
border-radius: var(--radius-lg);
overflow: hidden;
}
.book-detail-cover img {
width: 100%;
height: 100%;
object-fit: cover;
}
.book-detail-meta {
flex: 1;
}
.book-detail-meta h1 {
font-size: 1.75rem;
font-weight: 700;
margin-bottom: 4px;
}
.book-detail-author {
font-size: 1.1rem;
color: var(--color-text-muted);
margin-bottom: 12px;
}
.book-detail-isbn {
font-size: 0.85rem;
color: var(--color-text-muted);
margin-top: 8px;
}
.book-detail-progress {
margin: 20px 0;
}
.book-detail-progress .progress-text {
display: flex;
gap: 16px;
font-size: 0.85rem;
}
.book-detail-actions {
display: flex;
gap: 10px;
flex-wrap: wrap;
}
.book-detail-description {
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius-lg);
padding: 24px;
}
.book-detail-description h3 {
font-size: 1.1rem;
margin-bottom: 12px;
}
.book-detail-description p {
color: var(--color-text-muted);
line-height: 1.7;
}
/* === Form === */
.book-form {
display: flex;
flex-direction: column;
gap: 16px;
}
.form-error {
background: rgba(239, 68, 68, 0.1);
border: 1px solid var(--color-danger);
color: var(--color-danger);
padding: 10px 14px;
border-radius: var(--radius);
font-size: 0.875rem;
}
.form-group {
display: flex;
flex-direction: column;
gap: 6px;
}
.form-group label {
font-size: 0.85rem;
font-weight: 500;
color: var(--color-text-muted);
}
.form-group input,
.form-group textarea,
.form-group select {
padding: 10px 14px;
background: var(--color-bg);
border: 1px solid var(--color-border);
border-radius: var(--radius);
color: var(--color-text);
font-size: 0.9rem;
font-family: inherit;
}
.form-group input:focus,
.form-group textarea:focus,
.form-group select:focus {
outline: none;
border-color: var(--color-primary);
}
.form-group textarea {
resize: vertical;
min-height: 80px;
}
.form-row {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
gap: 16px;
}
.form-actions {
display: flex;
gap: 10px;
margin-top: 8px;
}
/* === Modal === */
.modal-overlay {
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.6);
display: flex;
align-items: flex-start;
justify-content: center;
padding-top: 80px;
z-index: 200;
}
.modal-content {
background: var(--color-surface);
border: 1px solid var(--color-border);
border-radius: var(--radius-lg);
padding: 32px;
width: 100%;
max-width: 560px;
max-height: 80vh;
overflow-y: auto;
}
.modal-content h2 {
margin-bottom: 20px;
}
/* === Pagination === */
.pagination {
display: flex;
align-items: center;
justify-content: center;
gap: 16px;
margin-top: 32px;
}
.page-info {
font-size: 0.875rem;
color: var(--color-text-muted);
}
/* === States === */
.loading-spinner {
text-align: center;
padding: 48px;
color: var(--color-text-muted);
font-size: 1rem;
}
.empty-state {
text-align: center;
padding: 64px 24px;
color: var(--color-text-muted);
}
.empty-state p {
margin-bottom: 8px;
}
.error-message {
text-align: center;
padding: 32px;
color: var(--color-danger);
}
/* === Responsive === */
@media (max-width: 768px) {
.books-grid {
grid-template-columns: 1fr;
}
.book-detail-header {
flex-direction: column;
align-items: center;
text-align: center;
}
.book-detail-actions {
justify-content: center;
}
.library-controls {
flex-direction: column;
}
.library-stats {
grid-template-columns: repeat(2, 1fr);
}
.form-row {
grid-template-columns: 1fr;
}
}
+32
View File
@@ -0,0 +1,32 @@
import { lazy, Suspense } from 'react';
import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom';
import './App.css';
const Library = lazy(() => import('./components/Library').then((m) => ({ default: m.Library })));
function App() {
return (
<BrowserRouter>
<div className="app">
<header className="app-header">
<div className="app-header-inner">
<a href="/" className="app-logo" onClick={(e) => { e.preventDefault(); window.location.href = '/'; }}>
<span className="logo-icon">📚</span>
<span className="logo-text">Cloud Reader</span>
</a>
</div>
</header>
<main className="app-main">
<Suspense fallback={<div className="loading-spinner">Loading...</div>}>
<Routes>
<Route path="/" element={<Library />} />
<Route path="*" element={<Navigate to="/" replace />} />
</Routes>
</Suspense>
</main>
</div>
</BrowserRouter>
);
}
export default App;
+90
View File
@@ -0,0 +1,90 @@
import axios from 'axios';
import type { Book, BookFormData, BookListResponse, BookStats } from '../types';
const api = axios.create({
baseURL: '/api',
headers: {
'Content-Type': 'application/json',
},
withCredentials: true,
});
api.interceptors.response.use(
(response) => response,
(error) => {
if (error.response?.status === 403) {
window.location.href = '/login';
}
return Promise.reject(error);
},
);
export async function fetchBooks(params?: {
page?: number;
sort_by?: string;
reading_status?: string;
search?: string;
}): Promise<BookListResponse> {
const response = await api.get<BookListResponse>('/books/', { params });
return response.data;
}
export async function fetchBook(id: number): Promise<Book> {
const response = await api.get<Book>(`/books/${id}/`);
return response.data;
}
export async function createBook(data: BookFormData): Promise<Book> {
const response = await api.post<Book>('/books/', data);
return response.data;
}
export async function updateBook(id: number, data: Partial<BookFormData>): Promise<Book> {
const response = await api.patch<Book>(`/books/${id}/`, data);
return response.data;
}
export async function deleteBook(id: number): Promise<void> {
await api.delete(`/books/${id}/`);
}
export async function markBookAsFinished(id: number): Promise<Book> {
const response = await api.post<Book>(`/books/${id}/mark_finished/`);
return response.data;
}
export async function fetchBookStats(): Promise<BookStats> {
const response = await api.get<BookStats>('/books/stats/');
return response.data;
}
export async function login(username: string, password: string): Promise<void> {
// Get CSRF token from any existing session
const csrfToken = extractCsrfToken();
if (!csrfToken) {
// Make a light request to set the CSRF cookie
await fetch('/api/books/', { credentials: 'include' });
}
const token = extractCsrfToken();
const resp = await fetch('/api-auth/login/', {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'X-CSRFToken': token,
},
body: new URLSearchParams({ username, password }),
credentials: 'include',
});
if (!resp.ok) {
throw new Error('Login failed');
}
}
function extractCsrfToken(): string {
const match = document.cookie.match(/csrftoken=([\w-]+)/);
return match ? match[1] : '';
}
export default api;
Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

After

Width:  |  Height:  |  Size: 4.0 KiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 8.5 KiB

+54
View File
@@ -0,0 +1,54 @@
import type { Book } from '../types';
import { READING_STATUS_LABELS, READING_STATUS_COLORS } from '../types';
interface BookCardProps {
book: Book;
onClick: (book: Book) => void;
}
export function BookCard({ book, onClick }: BookCardProps) {
const progress = book.reading_progress;
const statusColor = READING_STATUS_COLORS[book.reading_status];
return (
<article
className="book-card"
onClick={() => onClick(book)}
role="button"
tabIndex={0}
onKeyDown={(e: React.KeyboardEvent) => {
if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault();
onClick(book);
}
}}
>
<div className="book-card-cover">
{book.cover_image_url ? (
<img src={book.cover_image_url} alt={`Cover of ${book.title}`} loading="lazy" />
) : (
<div className="book-card-placeholder">
<span>{book.title.charAt(0)}</span>
</div>
)}
</div>
<div className="book-card-info">
<h3 className="book-card-title">{book.title}</h3>
<p className="book-card-author">{book.author}</p>
{book.genre && <span className="book-card-genre">{book.genre}</span>}
<div className="book-card-progress">
<div className="progress-bar">
<div
className="progress-fill"
style={{ width: `${Math.min(progress, 100)}%`, backgroundColor: statusColor }}
/>
</div>
<div className="progress-text">
<span style={{ color: statusColor }}>{READING_STATUS_LABELS[book.reading_status]}</span>
<span>{progress}%</span>
</div>
</div>
</div>
</article>
);
}
+151
View File
@@ -0,0 +1,151 @@
import { useState, useEffect, useCallback } from 'react';
import type { Book, BookFormData } from '../types';
import { READING_STATUS_LABELS, READING_STATUS_COLORS } from '../types';
import { fetchBook, updateBook, markBookAsFinished, deleteBook } from '../api/books';
import { BookForm } from './BookForm';
interface BookDetailProps {
bookId: number;
onBack: () => void;
onUpdated: () => void;
}
export function BookDetail({ bookId, onBack, onUpdated }: BookDetailProps) {
const [book, setBook] = useState<Book | null>(null);
const [loading, setLoading] = useState(true);
const [editing, setEditing] = useState(false);
const [error, setError] = useState<string | null>(null);
const loadBook = useCallback(async () => {
setLoading(true);
setError(null);
try {
const data = await fetchBook(bookId);
setBook(data);
} catch {
setError('Failed to load book details.');
} finally {
setLoading(false);
}
}, [bookId]);
useEffect(() => {
loadBook();
}, [loadBook]);
const handleUpdate = useCallback(
async (formData: BookFormData) => {
const updated = await updateBook(bookId, formData);
setBook(updated);
setEditing(false);
onUpdated();
},
[bookId, onUpdated],
);
const handleMarkFinished = useCallback(async () => {
const updated = await markBookAsFinished(bookId);
setBook(updated);
onUpdated();
}, [bookId, onUpdated]);
const handleDelete = useCallback(async () => {
if (!window.confirm('Are you sure you want to delete this book?')) return;
await deleteBook(bookId);
onBack();
onUpdated();
}, [bookId, onBack, onUpdated]);
if (loading) {
return <div className="loading-spinner">Loading...</div>;
}
if (error || !book) {
return <div className="error-message">{error ?? 'Book not found.'}</div>;
}
if (editing) {
return (
<div className="book-detail">
<button className="btn btn-secondary" onClick={() => setEditing(false)}>
Back to Details
</button>
<h2>Edit Book</h2>
<BookForm
initialData={book}
onSubmit={handleUpdate}
onCancel={() => setEditing(false)}
/>
</div>
);
}
const statusColor = READING_STATUS_COLORS[book.reading_status];
return (
<div className="book-detail">
<button className="btn btn-secondary" onClick={onBack}>
Back to Library
</button>
<div className="book-detail-header">
<div className="book-detail-cover">
{book.cover_image_url ? (
<img src={book.cover_image_url} alt={`Cover of ${book.title}`} />
) : (
<div className="book-card-placeholder large">
<span>{book.title.charAt(0)}</span>
</div>
)}
</div>
<div className="book-detail-meta">
<h1>{book.title}</h1>
<p className="book-detail-author">by {book.author}</p>
{book.genre && <span className="book-card-genre">{book.genre}</span>}
{book.isbn && <p className="book-detail-isbn">ISBN: {book.isbn}</p>}
<div className="book-detail-progress">
<div className="progress-bar large">
<div
className="progress-fill"
style={{ width: `${Math.min(book.reading_progress, 100)}%`, backgroundColor: statusColor }}
/>
</div>
<div className="progress-text">
<span style={{ color: statusColor }}>
{READING_STATUS_LABELS[book.reading_status]}
</span>
<span>{book.reading_progress}% complete</span>
{book.total_pages > 0 && (
<span>
Page {book.current_page} of {book.total_pages}
</span>
)}
</div>
</div>
<div className="book-detail-actions">
{book.reading_status !== 'finished' && (
<button className="btn btn-success" onClick={handleMarkFinished}>
Mark as Finished
</button>
)}
<button className="btn btn-primary" onClick={() => setEditing(true)}>
Edit Details
</button>
<button className="btn btn-danger" onClick={handleDelete}>
Delete
</button>
</div>
</div>
</div>
{book.description && (
<div className="book-detail-description">
<h3>Description</h3>
<p>{book.description}</p>
</div>
)}
</div>
);
}
+209
View File
@@ -0,0 +1,209 @@
import { useState, useCallback, useEffect, useRef } from 'react';
import type { Book, BookFormData, ReadingStatus } from '../types';
import { READING_STATUS_LABELS } from '../types';
interface BookFormProps {
initialData?: Book;
onSubmit: (data: BookFormData) => Promise<void>;
onCancel: () => void;
isLoading?: boolean;
}
export function BookForm({ initialData, onSubmit, onCancel, isLoading }: BookFormProps) {
const [formData, setFormData] = useState<BookFormData>({
title: initialData?.title ?? '',
author: initialData?.author ?? '',
genre: initialData?.genre ?? '',
description: initialData?.description ?? '',
cover_image_url: initialData?.cover_image_url ?? '',
isbn: initialData?.isbn ?? '',
total_pages: initialData?.total_pages ?? 0,
current_page: initialData?.current_page ?? 0,
reading_status: initialData?.reading_status ?? 'not_started',
});
const [error, setError] = useState<string | null>(null);
const titleRef = useRef<HTMLInputElement>(null);
useEffect(() => {
titleRef.current?.focus();
}, []);
const handleChange = useCallback(
(e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => {
const { name, value } = e.target;
setFormData((prev) => ({
...prev,
[name]:
name === 'total_pages' || name === 'current_page'
? Math.max(0, parseInt(value, 10) || 0)
: value,
}));
},
[],
);
const handleSubmit = useCallback(
async (e: React.FormEvent) => {
e.preventDefault();
setError(null);
if (!formData.title.trim()) {
setError('Title is required.');
return;
}
if (!formData.author.trim()) {
setError('Author is required.');
return;
}
if (formData.current_page > formData.total_pages && formData.total_pages > 0) {
setError('Current page cannot exceed total pages.');
return;
}
try {
await onSubmit(formData);
} catch (err) {
if (err instanceof Error) {
setError(err.message);
} else {
setError('Failed to save book.');
}
}
},
[formData, onSubmit],
);
return (
<form onSubmit={handleSubmit} className="book-form">
{error && <div className="form-error">{error}</div>}
<div className="form-group">
<label htmlFor="title">Title *</label>
<input
ref={titleRef}
id="title"
name="title"
type="text"
value={formData.title}
onChange={handleChange}
placeholder="Book title"
required
/>
</div>
<div className="form-group">
<label htmlFor="author">Author *</label>
<input
id="author"
name="author"
type="text"
value={formData.author}
onChange={handleChange}
placeholder="Author name"
required
/>
</div>
<div className="form-row">
<div className="form-group">
<label htmlFor="genre">Genre</label>
<input
id="genre"
name="genre"
type="text"
value={formData.genre}
onChange={handleChange}
placeholder="e.g. Fiction, Science"
/>
</div>
<div className="form-group">
<label htmlFor="isbn">ISBN</label>
<input
id="isbn"
name="isbn"
type="text"
value={formData.isbn}
onChange={handleChange}
placeholder="ISBN number"
/>
</div>
</div>
<div className="form-group">
<label htmlFor="description">Description</label>
<textarea
id="description"
name="description"
value={formData.description}
onChange={handleChange}
placeholder="Book description"
rows={3}
/>
</div>
<div className="form-group">
<label htmlFor="cover_image_url">Cover Image URL</label>
<input
id="cover_image_url"
name="cover_image_url"
type="url"
value={formData.cover_image_url}
onChange={handleChange}
placeholder="https://example.com/cover.jpg"
/>
</div>
<div className="form-row">
<div className="form-group">
<label htmlFor="total_pages">Total Pages</label>
<input
id="total_pages"
name="total_pages"
type="number"
min={0}
value={formData.total_pages}
onChange={handleChange}
/>
</div>
<div className="form-group">
<label htmlFor="current_page">Current Page</label>
<input
id="current_page"
name="current_page"
type="number"
min={0}
value={formData.current_page}
onChange={handleChange}
/>
</div>
<div className="form-group">
<label htmlFor="reading_status">Status</label>
<select
id="reading_status"
name="reading_status"
value={formData.reading_status}
onChange={handleChange}
>
{(Object.keys(READING_STATUS_LABELS) as ReadingStatus[]).map((status) => (
<option key={status} value={status}>
{READING_STATUS_LABELS[status]}
</option>
))}
</select>
</div>
</div>
<div className="form-actions">
<button type="submit" className="btn btn-primary" disabled={isLoading}>
{isLoading ? 'Saving...' : initialData ? 'Update Book' : 'Add Book'}
</button>
<button type="button" className="btn btn-secondary" onClick={onCancel}>
Cancel
</button>
</div>
</form>
);
}
+227
View File
@@ -0,0 +1,227 @@
import { useState, useEffect, useCallback, useMemo } from 'react';
import type { Book, ReadingStatus } from '../types';
import { READING_STATUS_LABELS } from '../types';
import { fetchBooks, fetchBookStats, createBook } from '../api/books';
import type { BookStats, BookFormData } from '../types';
import { BookCard } from './BookCard';
import { BookDetail } from './BookDetail';
import { BookForm } from './BookForm';
type View = 'library' | 'detail' | 'add';
export function Library() {
const [view, setView] = useState<View>('library');
const [selectedBookId, setSelectedBookId] = useState<number | null>(null);
const [books, setBooks] = useState<Book[]>([]);
const [stats, setStats] = useState<BookStats | null>(null);
const [loading, setLoading] = useState(true);
const [search, setSearch] = useState('');
const [sortBy, setSortBy] = useState('-updated_at');
const [statusFilter, setStatusFilter] = useState<string>('');
const [currentPage, setCurrentPage] = useState(1);
const [totalCount, setTotalCount] = useState(0);
const [showForm, setShowForm] = useState(false);
const loadBooks = useCallback(async () => {
setLoading(true);
try {
const data = await fetchBooks({
page: currentPage,
sort_by: sortBy || undefined,
reading_status: statusFilter || undefined,
search: search || undefined,
});
setBooks(data.results);
setTotalCount(data.count);
} catch {
setBooks([]);
} finally {
setLoading(false);
}
}, [currentPage, sortBy, statusFilter, search]);
const loadStats = useCallback(async () => {
try {
const data = await fetchBookStats();
setStats(data);
} catch {
// Stats are non-critical
}
}, []);
useEffect(() => {
loadBooks();
loadStats();
}, [loadBooks, loadStats]);
const handleBookClick = useCallback((book: Book) => {
setSelectedBookId(book.id);
setView('detail');
}, []);
const handleBackToLibrary = useCallback(() => {
setView('library');
setSelectedBookId(null);
}, []);
const handleUpdated = useCallback(() => {
loadBooks();
loadStats();
}, [loadBooks, loadStats]);
const handleAddBook = useCallback(
async (data: BookFormData) => {
await createBook(data);
setShowForm(false);
await loadBooks();
await loadStats();
},
[loadBooks, loadStats],
);
const totalPages = useMemo(() => Math.max(1, Math.ceil(totalCount / 20)), [totalCount]);
if (view === 'detail' && selectedBookId) {
return (
<BookDetail
bookId={selectedBookId}
onBack={handleBackToLibrary}
onUpdated={handleUpdated}
/>
);
}
return (
<div className="library">
<div className="library-header">
<h1>My Library</h1>
<button className="btn btn-primary" onClick={() => setShowForm(true)}>
+ Add Book
</button>
</div>
{stats && (
<div className="library-stats">
<div className="stat-card">
<span className="stat-value">{stats.total_books}</span>
<span className="stat-label">Total</span>
</div>
<div className="stat-card">
<span className="stat-value" style={{ color: '#22c55e' }}>{stats.finished}</span>
<span className="stat-label">Finished</span>
</div>
<div className="stat-card">
<span className="stat-value" style={{ color: '#3b82f6' }}>{stats.reading}</span>
<span className="stat-label">Reading</span>
</div>
<div className="stat-card">
<span className="stat-value" style={{ color: '#6b7280' }}>{stats.not_started}</span>
<span className="stat-label">Unread</span>
</div>
</div>
)}
{showForm && (
<div className="modal-overlay">
<div className="modal-content">
<h2>Add New Book</h2>
<BookForm
onSubmit={handleAddBook}
onCancel={() => setShowForm(false)}
/>
</div>
</div>
)}
<div className="library-controls">
<input
type="search"
className="search-input"
placeholder="Search by title or author..."
value={search}
onChange={(e: React.ChangeEvent<HTMLInputElement>) => {
setSearch(e.target.value);
setCurrentPage(1);
}}
/>
<select
value={sortBy}
onChange={(e: React.ChangeEvent<HTMLSelectElement>) => {
setSortBy(e.target.value);
setCurrentPage(1);
}}
className="sort-select"
>
<option value="-updated_at">Recently Updated</option>
<option value="title">Title (A-Z)</option>
<option value="-title">Title (Z-A)</option>
<option value="author">Author (A-Z)</option>
<option value="-author">Author (Z-A)</option>
<option value="-created_at">Recently Added</option>
<option value="-reading_progress">Most Progress</option>
<option value="reading_progress">Least Progress</option>
</select>
<select
value={statusFilter}
onChange={(e: React.ChangeEvent<HTMLSelectElement>) => {
setStatusFilter(e.target.value);
setCurrentPage(1);
}}
className="filter-select"
>
<option value="">All Status</option>
{(Object.keys(READING_STATUS_LABELS) as ReadingStatus[]).map((status) => (
<option key={status} value={status}>
{READING_STATUS_LABELS[status]}
</option>
))}
</select>
</div>
{loading ? (
<div className="loading-spinner">Loading books...</div>
) : books.length === 0 ? (
<div className="empty-state">
<p>No books found.</p>
{search || statusFilter ? (
<p>Try adjusting your search or filters.</p>
) : (
<p>Add your first book to get started!</p>
)}
</div>
) : (
<>
<div className="books-grid">
{books.map((book) => (
<BookCard key={book.id} book={book} onClick={handleBookClick} />
))}
</div>
{totalPages > 1 && (
<div className="pagination">
<button
className="btn btn-secondary"
disabled={currentPage <= 1}
onClick={() => setCurrentPage((p) => Math.max(1, p - 1))}
>
Previous
</button>
<span className="page-info">
Page {currentPage} of {totalPages}
</span>
<button
className="btn btn-secondary"
disabled={currentPage >= totalPages}
onClick={() => setCurrentPage((p) => p + 1)}
>
Next
</button>
</div>
)}
</>
)}
</div>
);
}
+16
View File
@@ -0,0 +1,16 @@
/* Base reset — main styles in App.css */
*,
*::before,
*::after {
box-sizing: border-box;
margin: 0;
padding: 0;
}
body {
margin: 0;
}
#root {
min-height: 100vh;
}
+10
View File
@@ -0,0 +1,10 @@
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.tsx'
createRoot(document.getElementById('root')!).render(
<StrictMode>
<App />
</StrictMode>,
)
+58
View File
@@ -0,0 +1,58 @@
export interface Book {
id: number;
title: string;
author: string;
genre: string;
description: string;
cover_image_url: string;
isbn: string;
total_pages: number;
current_page: number;
reading_status: ReadingStatus;
reading_progress: number;
owner: string;
created_at: string;
updated_at: string;
}
export type ReadingStatus = 'not_started' | 'reading' | 'finished' | 'dnf';
export interface BookListResponse {
count: number;
next: string | null;
previous: string | null;
results: Book[];
}
export interface BookStats {
total_books: number;
finished: number;
reading: number;
not_started: number;
}
export interface BookFormData {
title: string;
author: string;
genre: string;
description: string;
cover_image_url: string;
isbn: string;
total_pages: number;
current_page: number;
reading_status: ReadingStatus;
}
export const READING_STATUS_LABELS: Record<ReadingStatus, string> = {
not_started: 'Not Started',
reading: 'Reading',
finished: 'Finished',
dnf: 'Did Not Finish',
};
export const READING_STATUS_COLORS: Record<ReadingStatus, string> = {
not_started: '#6b7280',
reading: '#3b82f6',
finished: '#22c55e',
dnf: '#ef4444',
};
+1
View File
@@ -0,0 +1 @@
/// <reference types="vite/client" />