Phonebook: a Storybook-style preview gallery for SwiftUI and Compose

Description and use

Phonebook harvests existing @Preview/#Preview annotations from mobile codebases and publishes a static HTML gallery, enabling designers, PMs, and QA to view all UI states without IDEs.

Problem

Designers, PMs, and QA often need to view all UI states (enabled/disabled, dark mode, empty, loading) but native preview tools are confined to the developer IDE and cannot be easily shared.

Outcome

Phonebook turns existing mobile UI previews into a shareable, static gallery, eliminating the need for separate Storybook setups or external screenshot services.

Workflow

• 1. Add phonebook.config.json to the project root specifying appName, platform, and Android modules/variant or iOS settings.
• 2. Run phonebook generate phonebook build on CI or locally; generate renders previews using Robolectric/Roborazzi and outputs a bundle (manifest.json, images).
• 3. build consumes the bundle and writes a plain static site (index.html, assets).
• 4. Deploy the generated folder to GitHub Pages, S3, Netlify, or any static host, or open it locally.
• 5. Stakeholders view the gallery to inspect all UI states without needing IDEs or debug builds.

Evidence

Phonebook has two main commands: phonebook generate phonebook build

Source

Phonebook does not care. You can open it from file://. You can upload it to GitHub Pages.

Source