pug-mockup

Generate self-contained Pug SPA mockups that compile to a single HTML file.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/duylamle/product-collection --skill pug-mockup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pug-mockup
Source: https://github.com/duylamle/product-collection/tree/main/skills/pug-mockup
Command: npx skills add https://github.com/duylamle/product-collection --skill pug-mockup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly turns product and design ideas into clickable, shareable prototypes without requiring frameworks or servers, removing the friction of building and shipping demo UIs for stakeholder review.

Core Features & Use Cases

  • Single-file output: compiles Pug templates into one self-contained HTML file with CSS and JS inlined for offline sharing.
  • Component-driven templates: mixins, pages, and a starter template speed up multi-page mockups and iterative edits.
  • Iterative workflow: guidance and project CLAUDE.md mapping for targeted edits, conversion guides to production frameworks, and asset embedding conventions for images and icons.
  • Use case: create a 5–15 page dashboard prototype for stakeholder demos, iterate one page at a time, then convert the approved layout into React/Vue components.

Quick Start

In Claude Code, ask it to "create a mockup for a 5-page task manager with a sidebar layout, blue primary color, and pages: dashboard, tasks, task detail, settings, login."

Frequently Asked Questions about pug-mockup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a self-contained HTML mockup for offline stakeholder demos?

To create a self-contained HTML mockup, use Pug templates to compile your SPA prototype into a single file with inlined CSS and JS. This approach removes the need for servers or frameworks, producing a shareable dist/index.html file for offline stakeholder review.

What is the best way to prototype a multi-page SPA without using a web framework?

The best way to prototype a multi-page SPA without a web framework is using Pug mixins and hash-based routing. This method generates a component-driven project that compiles directly into a standalone HTML file, enabling rapid iterative UI design without server dependencies.

Can I use Lucide SVG icons and embedded assets in a Pug mockup?

Yes, you can use Lucide SVG icons and embedded assets in a Pug mockup. The project includes specific asset embedding conventions to inline images and icons directly into the single-file HTML output, ensuring the prototype remains fully self-contained for offline sharing.

Does pug-mockup support converting prototypes to production frameworks like React or Vue?

Pug-mockup supports converting prototypes to production frameworks through included conversion guides. After iterating on your component-driven Pug templates, you can translate the approved UI layouts directly into React or Vue components for production development.

How many pages can I prototype with a single Pug mockup project?

You can prototype 5 to 30 pages within a single Pug mockup project. This scale is ideal for small to mid-size apps, allowing you to iteratively edit individual pages using Pug mixins before compiling everything into one self-contained HTML file.

Do I need pug-cli installed to compile a single-file SPA prototype?

Yes, you need pug-cli installed to execute the build step. The pug-cli tool compiles your Pug templates, along with inlined CSS and JS, into the final dist/index.html file required for your self-contained offline SPA mockup.