Skip to content

mgurbuz-tr/ss-gen

Repository files navigation

App Store Screenshot Generator

A Next.js-based tool to quickly produce modern screenshots for the Apple App Store and Google Play.

Attribution and Foundation

This project is built on top of an open-source foundation and was inspired by the App Store Screenshot Generator. See: storesnaps.com (source).

alt text

What’s New in This Repository

  • Multi-screen workspace: Add/remove multiple screens in one project and preview side by side.
  • Persistent session: Your settings and screens are saved in the browser; resume later with a Continue/Start over flow.
  • Rich text editing: Simple markers for bold/italic (**bold**, *italic*, ***both***), line wrapping/layout, text alignment and rotation.
  • Google Fonts integration: Selected fonts are loaded and the canvas re-renders accordingly.
  • Layered overlays: Drag-and-drop PNG/JPG assets, position/scale/rotate them as layers.
  • Frame controls: Fine-grained bezel width/color, device size factor, and corner radius.
  • Backgrounds: Solid color or angled gradients.
  • Strict size validation: Enforces exact pixel dimensions per device (compatible with App Store/Fastlane requirements).
  • Bulk export: Download all rendered screens as a ZIP with device-aware filenames.
  • Performance-focused preview: Offscreen render canvas copied into a display canvas for smoother updates.

Supported Devices (Portrait)

  • iPhone 16 Pro Max 6.9" — 1290×2796
  • iPhone 14 Plus 6.5" — 1284×2778
  • iPad Pro 11" — 1488×2266

Getting Started

npm install

# (Optional) Firebase Analytics env vars
# Copy .env.example to .env.local and fill in values

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 in your browser.

Note: In development, Analytics events are not sent to Firebase; they are logged to the console.

Usage

  • Pick a device and manage screens: Use the left panel to choose a device, add or remove screens.
  • Upload screenshots: Click or drag-and-drop. The tool enforces exact pixel sizes for the selected device.
  • Edit text: Use the rich text editor for headings/body; adjust font, size, alignment, and rotation.
  • Add overlays: Drop PNG/JPG assets as layers; move, scale, and rotate them.
  • Background and frame: Choose solid/gradient backgrounds; tweak bezel/radius and other frame settings.
  • Export: Download all screens as a ZIP from the live preview card.

Roadmap / TODO

  • Real device bezels for some models
  • 3D device models (front/isometric mockups)
  • Device orientations (portrait + landscape)
  • Background image layer

Acknowledgements

This project extends an open community foundation. Inspiration and base flow: storesnaps.com (source).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages