Books & Reader Feature

S
Swiftspeed Team
Updated May 21, 20264 min read

What is the Books & Reader Feature?

Books & Reader turns your app into a native ebook library. You upload EPUB files in the editor; the platform extracts the chapters into a true reflowable reader so your readers get adjustable text size, light and dark themes, bookmarks, read-aloud (text to speech), reading progress, and offline reading. Embedded audio in a book plays through the native engine with lock-screen controls.

Five editor tabs control the feature: Library to upload and manage books, Categories to group them into shelves like "Trending", Appearance for the mode, theme and home layout, Storage for where book files live, and Reports for reader activity.

Adding the Books & Reader Feature

In the App editor, click Features in the top bar.

App editor Features tab

Find the Books & Reader card and click the + button to add it.

Add a Page list with the Books & Reader card highlighted

Library Tab: Uploading Books

The Library tab is where you upload and manage books. Click Choose EPUB file to upload a book. The platform extracts the chapters automatically; the heavy source file is discarded, only the lightweight reader content is kept. The list below is searchable and paginated (20 at a time), with multi-select and bulk delete for large libraries. Use the pencil icon to edit a book's title, author, or categories.

Books & Reader Library tab

Categories Tab: Organising Books

Group books into named categories (for example "Trending", "New arrivals", "Classics"). Toggle Show on home to make a category appear as a horizontal shelf on the reader home; categories that are not on home still work as filters on the browse page. Assign books to a category from the Library tab when you upload or edit a book.

Books & Reader Categories tab

Appearance Tab: Mode, Theme and Layout

Choose the Mode: Library (many books, with categories and a browse page) or Single book (one book that opens straight into the reader, ideal for a single-title app). Pick a reading theme from the six-theme family and a home structure (Shelf, Cover Flow, or Continue). Custom colors let you override any theme token. Reading apps reward calm, high-contrast palettes; users read for long stretches.

Books & Reader Appearance tab

Storage Tab: Where Book Files Live

By default, extracted book content is stored on the platform (capped). If you upload many large books, switch to your own external storage (S3, Google Cloud Storage, or FTP/FTPS) here and paste your bucket credentials. Books uploaded after switching are routed to your storage automatically; if external storage is misconfigured the upload safely falls back to local.

Books & Reader Storage tab

Reports Tab

See how many readers opened your books, which titles are most read, and the list of readers (searchable and paginated). Remove a reader's reading history and bookmarks from here if needed.

Books & Reader Reports tab

Live Preview

This is the actual native UI. Greeting and search at the top, a passage of the day, a reading-streak strip, filter chips, category shelves, a Continue-reading rail, and the full library grid. Tapping a book opens the reflowable reader with adjustable size, themes, read-aloud, and bookmarks.

iPhone phone frame rendering the live Books & Reader home

Tips

  • Use categories as shelves. A home with "Trending" and "New arrivals" shelves reads like a real bookstore and surfaces more of your catalogue than a flat list.
  • Single-book mode is perfect for a one-title app. It skips the library entirely and opens straight into the reader, so the whole app is the book.
  • Switch to your own storage before uploading a big catalogue. Local storage is capped; S3 / GCS / FTP scale with you and keep your platform footprint small.
  • Read-aloud uses the device's native voice. It works on the lock screen and keeps playing in the background, so your app doubles as an audiobook player.
  • EPUB only. Export from Word, Google Docs, Calibre, or any publishing tool to EPUB before uploading. Public-domain classics from Project Gutenberg are a quick way to seed a demo library.

Removing the Feature

Back on Features, find the Books & Reader row, click the red trash icon, and confirm. This removes the feature and all its uploaded books from this app.

Features page with the Books & Reader row and red remove button highlighted