storeframe
Frame raw app captures for the App Store and Google Play: a gradient background, the capture inside a drawn device body (no mockup PNGs), a fitted two-line headline, and optional decorations that run across the whole gallery.
Working name.
frameappis already taken on PyPI; renaming is one search-and-replace ofstoreframe.
Install
pip install storeframe # once published
pip install -e '.[dev]' # from this checkout
Use
# frame a fastlane-style tree: captures/<locale>/*.png -> framed/<locale>/*.png
storeframe frame design.json --platform android --captured fastlane/screenshots --out fastlane/framed
storeframe frame design.json --platform ios --captured fastlane/screenshots --out fastlane/framed --locale en-US
# Play's 1024x500 feature graphic, from the first screen's phone capture
storeframe frame design.json --platform android --captured ... --out ... --feature-graphic
# one picture
storeframe one design.json capture.png out.png --screen 01-path --platform ios
storeframe devices # list devices, platforms, styles
from PIL import Image
import storeframe
design = storeframe.Design.load("design.json")
picture = storeframe.screenshot(Image.open("phone-01-path.png"), design, "01-path",
kind="phone", device="pixel-pro", canvas_size=(1440, 2560))
Platforms and devices
| Platform | Kind | Device | Output canvas |
|---|---|---|---|
android |
phone |
pixel-pro |
1440×2560 (Play refuses > 2:1) |
android |
tablet |
pixel-tablet |
1600×2560 |
ios |
iphone |
iphone-pro-max |
capture size (App Store wants the device size) |
ios |
ipad |
ipad-pro-13 |
capture size |
A capture named <kind>-<screen>.png says its kind; otherwise (fastlane
snapshot names like iPhone 17 Pro Max-01-path.png) the kind is picked by
aspect ratio. The screen is the design screen whose name (or alias) the file
name ends with.
Device geometry is expressed as fractions of the screen width, so a device looks the same however large it is drawn.
Styles
plain– centred device, headline above.arc– a dashed parabola spanning the whole gallery, sun in the first picture, moon in the last.tabs– device off-centre, coloured tabs running off the left edge, a dashed line that crosses every picture (each one picks it up where the previous one left it) and a second line hanging off the tabs.
The design file
{
"style": "arc",
"font": "Nunito[wght].ttf",
"backgrounds": { "evening": ["#f2a65a", "#c9655b"] },
"chips": { "odt": "#4bb3e8" },
"screens": [
{
"name": "01-path",
"background": "evening",
"headline": { "en-US": ["See when the sun", "is where."] },
"chips": [],
"aliases": ["01-path-lite"]
}
],
"layouts": { "phone": { "screen_top": 0.22 } },
"params": { "phone": { "arc_peak": 0.15 } },
"options": { "moon": false }
}
fontis optional and relative to the design file; the bundled Nunito (SIL OFL) is the default. Hindi, Japanese and Chinese headlines use a system font (Noto on Linux, the system fonts on macOS).headlinefalls back fromde-ATtode/de-DE, then tofallback_locale(en-US).layouts/paramsoverride a style's numbers per device kind (phone,tablet,iphone,ipad,feature). Seesrc/storeframe/layout.pyand the style modules for what each number means.- Existing
frames.jsonfiles from OpenDocument.ios/.droid and almucantar load unchanged ("arc": true→arc, achipspalette →tabs). The OpenDocument "lite" capture needs"aliases": ["04-edit-lite"]on its screen.
Development
uv venv && uv pip install -e '.[dev]'
.venv/bin/pytest
License
MIT. The bundled Nunito font is under the SIL Open Font License 1.1 (src/storeframe/fonts/OFL.txt).
Metadata
Release files for storeframe 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| storeframe-0.1.0.tar.gz | 155.1 kB | With provenance | Details for storeframe-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| storeframe-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for storeframe-0.1.0-py3-none-any.whl |
Total release size: 316.6 kB
Release files / storeframe-0.1.0.tar.gz
| Download URL | storeframe-0.1.0.tar.gz |
|---|---|
| Size | 155.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4fa2c1361589ca8924c14bec32b59add0ed0334ad89d0a67481874379817335f
|
|
BLAKE2b-256 checksum How to use checksums |
b60d1041b48b33847e38cf30b912cd155104a04fe622641688d1da1ff7d23982
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logRelease files / storeframe-0.1.0-py3-none-any.whl
| Download URL | storeframe-0.1.0-py3-none-any.whl |
|---|---|
| Size | 161.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75d19f580fa271e1e7b23f186718c42414493523fa7a8db0cc81f677d99a8821
|
|
BLAKE2b-256 checksum How to use checksums |
0284d12907150172b6e34dfd76a1f8ff6fceafa5a23c0819805856696913841e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logSecurity for storeframe 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for storeframe-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.