Category Browse

RoleAll Users

PlatformWeb·App (iOS/Android)·Car

Versionv1.8.3

Updatedv1.9.5 · 2026-03-15

Category Browse allows you to explore the library by themes and genres.

Feature Overview

1. List Display

• Cover grid for category books.
• Infinite scrolling for large datasets.
• Responsive layout from mobile to desktop.

2. Interaction Details

• Click cover to open book detail.
• Loading indicator and no-more-data state.
• Permission warning (403) if user loses access.
• Empty state when no books exist in category.

Technical Rules

1. Visibility Filtering

• Clients must hide categories with enabled=0 (except admin context).
• Use backend category.id as unique route identifier.

2. Sorting

• Default by relation sort_order ascending.
• If equal, fallback to created_at ascending.

3. Data Linking

• Category updates should reflect in Discover and Category list in near real time.

FAQ

• Current list behavior in some entry pages may still fallback to latest-ingested order.