An iPad ebook reader for kids. Tap a word, hear it spoken.
Piperly loads EPUB books, wraps every word in a tappable element, and uses on-device text-to-speech to read words aloud. Kids build vocabulary by tapping words they don't know — each tap saves the word to a personal word list they can review later.
- EPUB reader powered by Readium Swift Toolkit
- Tap-to-speak — tap any word to hear it read aloud via AVSpeechSynthesizer
- Word list — automatically tracks tapped words with tap counts and book source
- Sticker bookmarks — kids mark pages with fun stickers instead of boring bookmark icons
- 7 reader themes — Piperly, Sunset, Ocean, Forest, Midnight, Cream, High Contrast
- Xcode 16.0+ (full install, not just Command Line Tools)
- iOS 17.0+ / iPadOS 17.0+ (iPad only)
- XcodeGen — generates the Xcode project from
project.yml - SwiftLint — optional, lints on build if installed
# Clone
git clone git@github.com:Interactive-Buffoonery/piperly.git
cd piperly
# Install tools
brew install xcodegen
brew install swiftlint # optional
# Generate Xcode project
xcodegen
# Open in Xcode
open Piperly.xcodeprojXcode will automatically resolve the Readium Swift Package Manager dependencies on first open. This can take a few minutes.
- Open
Piperly.xcodeprojin Xcode - Select an iPad simulator or connected iPad device
- For device builds or archives, select your own Development Team in Signing & Capabilities
- Build and run (⌘R)
For command-line verification, regenerate the project and use the shared Piperly
scheme:
xcodegen generate
xcodebuild -project Piperly.xcodeproj -scheme Piperly -showdestinations
xcodebuild -project Piperly.xcodeproj \
-scheme Piperly \
-destination 'generic/platform=iOS' \
-configuration Debug \
CODE_SIGNING_ALLOWED=NO \
buildThe CLI build requires the iOS platform components for the active Xcode version to be installed in Xcode > Settings > Components.
See docs/testflight-release-checklist.md for the repo-side metadata audit and archive checklist.
To archive and upload to TestFlight, configure signing with your own Apple developer account, register an appropriate bundle identifier in App Store Connect, create the app record, then archive and upload from Xcode Organizer. Keep signing identities, provisioning profiles, and local account settings out of the repository.
See docs/app-store-privacy-review.md for the current App Store Connect privacy answers, Kids Category posture, and external privacy policy draft. The current repo posture is no tracking and no collected data; local reading state remains on device.
Piperly/
├── App/ # App entry point
├── Models/ # Book, Bookmark, SavedWord, Voice, etc.
├── Services/ # BookStore and TTSEngine
├── Theme/ # Colors, Typography, ReaderTheme
├── Views/
│ ├── Library/ # Book grid, import, book cards
│ ├── Reader/ # EPUB reader, toolbar, word tap, TOC, bookmarks
│ ├── Settings/ # Voice setup and reading settings
│ └── Words/ # Saved word list and word chips
├── Resources/
│ ├── Assets.xcassets/ # App icon and colors
│ ├── word-tap.js # JS injected into EPUB for word tap detection
│ ├── reader-theme.css # Base reader styles
│ └── PrivacyInfo.xcprivacy
└── docs/ # Design mockups and color palette
Piperly is licensed under the GNU General Public License v3.0.