Chapter Reader
A fast, optimized reader with multiple viewing modes, auto-scrolling, keyboard navigation, and automatic chapter progression.
Premium Content Protection
Server-Side Rendering (SSR) Protection
Premium chapter access is validated server-side before rendering. Users without access are redirected immediately to a paywall page, preventing any image loading or content exposure.
Premium chapters can be configured with:
- Token cost - Number of tokens required to unlock the chapter
- Free after X days - Chapters become free after a configured period
- Subscription access - Premium subscribers get immediate access
- Automatic unlock calculation via virtual isFreeNow property
Reading Modes
The reader supports three viewing modes to accommodate different reading preferences and content types.
Long Strip
Continuous vertical scrolling, perfect for webtoons and manhwa. Supports auto-scroll with adjustable speed.
Single Page
Classic page-by-page reading with navigation arrows and keyboard controls.
Double Page
Two-page spread view for manga reading on wider screens.
Auto-Scroll Feature
The long strip mode includes an advanced auto-scroll feature with two modes:
Continuous Mode
Smooth, constant scrolling at an adjustable speed (1-10 pixels per frame).
- • Press Space to toggle
- • Press J to increase speed
- • Press K to decrease speed
Interval Mode
Scrolls a chunk (80% of viewport) every X seconds with smooth animation.
Configurable delay between 1-10 seconds.
Auto-Next Chapter
When reaching the end of a chapter in long strip mode, a 5-second countdown starts to automatically navigate to the next chapter. Users can cancel by scrolling up.
- Visual countdown indicator at the end of chapters
- Automatically disabled when no next chapter exists
- Can be toggled on/off in reader settings
- Respects chapter navigation linking to continue reading
Keyboard Shortcuts
Reader UI Components
The reader includes a comprehensive header bar with:
- Back to series button for easy navigation
- Series title and current chapter display
- Chapter dropdown for quick chapter switching
- Reading mode selector (Long Strip / Single Page / Double Page)
- Fullscreen toggle button
- Auto-hiding controls after 3 seconds of inactivity
Mobile Support
The reader is fully responsive and optimized for mobile devices.
- Touch-friendly navigation controls
- Responsive chapter selector dropdown
- Optimized image loading for mobile networks
- Full support for long strip vertical scrolling
- Pinch-to-zoom support for detailed panels
Image Optimization
The reader automatically optimizes images for the best viewing experience:
- Next.js Image component with automatic optimization
- Lazy loading for fast initial page load
- Image dimension tracking for proper layout
- Loading states with animated placeholders
- WebP format support for smaller file sizes