Skip to content

mockupkit/mockupkit.github.io

Repository files navigation

MockupKit

Live: mockupkit.github.io

Turn your website screenshots into a polished multi-device mockup scene — desktop, laptop, tablet, and phone on a clean studio backdrop — and download it as a single PNG for your portfolio.

Built for developers who want to showcase their websites — drop in your screenshots and get a portfolio-ready hero image in seconds.

MockupKit export

🚧 In progress: a feature to paste a website URL and auto-capture the screenshots at each device size, so you won't have to upload them manually.

v1 is fully client-side: upload a screenshot per device and the scene renders live on a canvas you can download. The URL auto-capture flow and accounts are on the roadmap (docs/ARCHITECTURE.md).

Quick start

npm install
npm run dev          # http://localhost:3000

Upload a screenshot into each device slot. For a pixel-perfect, crop-free fit, capture each at the size shown on its slot:

Device Capture size
Desktop 1920 × 1080
Laptop 1440 × 900
Tablet 820 × 1180
Phone 390 × 844

Pick a background — neutral or gradient presets, or a custom solid colour — and hit Download PNG.

Scripts

npm run dev        # dev server
npm run build      # production build
npm run lint       # eslint
npm run typecheck  # tsc --noEmit
npm run test:e2e   # Playwright e2e (auto-starts the dev server)

Tech

Next.js 16 (App Router) · React 19 · TypeScript · Tailwind v4 · Zustand · react-dropzone · Canvas 2D · Playwright.

See CLAUDE.md for project conventions and docs/ARCHITECTURE.md for the roadmap.

Deploy (GitHub Pages)

The app is a static export served at the org root https://mockupkit.github.io. A push to main runs .github/workflows/deploy.yml, which builds (npm run buildout/) and publishes to Pages. Enable it once in repo Settings → Pages → Source: GitHub Actions.

Author

Built by Shehwar Ahmadgithub.com/shehwar-ahmad.

About

Turn website screenshots into a polished multi-device mockup (desktop, laptop, tablet, phone) — free, in your browser. https://mockupkit.github.io

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors