Professional Marketing Mockup Generator powered by Google Gemini 2.5/3.0 Vision. Turn raw app screenshots into award-winning marketing assets in seconds.
Crafted by w3jdev
w3jdev.com · github.com/w3jdev · linkedin.com/in/w3jdev
MockupGenius AI is an enterprise-grade web application designed to automate the creation of high-fidelity product mockups. It utilizes a Dual-Layer Composite Rendering Architecture to separate screen content (UI) from environmental generation, ensuring text legibility while providing photorealistic lighting and physics.
- Dual-Layer Rendering: Upscales UI 300% and composites it onto AI-generated devices with physically accurate glass refraction.
- Contextual Intelligence: Automatically detects app category (Fintech, F&B) and generates relevant background props.
- SEO & Marketing Data: Auto-generates filenames, alt text, and social captions for every asset.
- A/B Testing: Generates variant angles and lighting setups for conversion optimization.
- Smart Image Replacement: Allows swapping screen content while retaining the exact generative environment.
If you are an AI coding assistant (Cursor, Copilot, Windsurf), YOU MUST READ AGENTS.md before making changes.
We follow a strict "Docs-as-Code" philosophy.
- System Overview: High-level design and data flow.
- Tech Stack: Libraries, tools, and decision rationale.
- Coding Standards: Style guides, linting, and patterns.
- API Contracts: Integration details with Gemini API.
- Product Requirements (PRD): Detailed feature specifications.
- Vision & Pitch: The "Why" and "What".
- Success Metrics: KPIs and validation criteria.
- Roadmap: Future milestones and release plan.
- Changelog: Version history.
- Testing Strategy: QA and validation protocols.
- Node.js v18+
- Google Gemini API Key (Paid Tier recommended for
gemini-3-pro-image-preview)
# Install dependencies
npm install
# Set up Environment
export API_KEY="your_google_api_key"
# Run Development Server
npm startThis application is client-side heavy. API Keys are passed via process.env. Ensure .env files are never committed to version control.