evolus/pencil sits at 9.9k stars on GitHub, written primarily in JavaScript. The Pencil Project's unique mission is to build a free and opensource tool for making diagrams and GUI prototyping that everyone can use.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
An open-source GUI prototyping and wireframing application for macOS, Windows, and Linux.
Website •
Downloads •
Stencils & Templates
Overview
Pencil is a free, open-source, desktop-native wireframing and prototyping tool for macOS, Windows, and Linux (pencil.evolus.vn). Built for developers, UX designers, and product teams, it provides an intuitive vector canvas environment for constructing mockups, system diagrams, and user flows using standard vector stencil libraries.
Key Capabilities & Architecture in V4.0
Pencil V4.0 introduces native support for the Model Context Protocol (MCP). This enables any AI assistant or LLM client that supports standard MCP (including Claude Desktop, Cursor, Antigravity, VS Code, or custom agents) to inspect, create, and modify wireframes directly on your canvas using everyday language. Pencil runs a local server right inside the app at http://127.0.0.1:1919/mcp, with no extra background services or cloud setups required.
Natural Language to Vector Canvas: AI assistants convert prompts (e.g. "Create a 3-tier pricing table using shadcn/ui") directly into canvas operations via MCP tools (insert_shapes, shift_layout). Components are positioned with calculated bounds, not flat image overlays.
True Vector Primitives: Generates native, fully editable vector stencils and shapes instead of raster bitmaps or static mockups. Every AI-created element can be resized, restyled, or reorganized on the canvas at any time.
100% Local-First & Private: All document data (.ep, .epz) and MCP requests stay strictly on your local machine over loopback (127.0.0.1). No cloud syncing, third-party analytics, or telemetry.
Autonomous Vision QA Loop: Exposes a visual snapshot mechanism (render_preview), allowing LLMs to inspect the rendered canvas, verify spacing/alignment/contrast, and perform iterative layout corrections autonomously.
Dynamic Layout & Spacing: Built-in container structures automatically manage padding, element distribution, and offsets, eliminating manual pixel math when appending or reordering components.
Stencil & Icon Introspection: Connected assistants can query installed stencil libraries (shadcn/ui, Bootstrap, Material Design, iOS, Flowcharts) and search icon catalogs (Tabler, Lucide, FontAwesome) on demand.
Quick Start (Prebuilt Binaries)
For end users who do not require building from source:
Download: Obtain the latest installer or package for your operating system from the Pencil Downloads Page or GitHub Releases.
Launch: Open Pencil. You can immediately begin creating wireframes and diagrams using the built-in stencil collections.
Connect AI (Optional): To enable AI-assisted prototyping, follow the setup in Connecting AI Clients below.
Connecting AI Clients
Pencil provides built-in configuration snippets for popular tools (Claude Desktop, Cursor, Antigravity, and VS Code), and works with any client or script that connects to standard MCP HTTP endpoints. Open Settings > MCP, select your assistant tab, and click Copy Configuration to paste directly into your client.
The internal server operates on http://127.0.0.1:1919/mcp (Streamable HTTP / JSON-RPC 2.0). Server status, port assignment, and restarts can be managed directly in the MCP settings pane. To verify endpoint responsiveness externally:
curl -I http://127.0.0.1:1919/mcp
Manual Client Configuration Reference
Claude Desktop
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows, ~/.config/Claude/ on Linux):
AI assistants connected to Pencil can execute complex multi-step canvas workflows. Below are representative prompts:
[!TIP]
Prompting Best Practice: For the cleanest layouts, explicitly reference your desired stencil library (e.g., "Use shadcn/ui stencils..." or "Pick an icon from the Lucide collection..."). This instructs the assistant to reuse standardized design system components instead of generic raw rectangles.
Scaffolding New Screens
"Use the shadcn/ui stencil collection to build a standard SaaS authentication screen with an email input, password field, 'Remember me' checkbox, and primary submit button."
"Create a three-tier pricing comparison table (Free, Pro, Enterprise) on the active page, highlighting the Pro tier with a primary accent border."
"Generate a mobile analytics dashboard page containing a top metrics card grid and a recent activity list below it."
Component Refinement & Styling
"Select all primary call-to-action buttons on this page, update their background fill to #2563EB, and apply an 8px corner radius."
"Adjust the horizontal spacing between the navigation header items to 24px and align them vertically to the center."
"Convert the current card grid layout from 3 columns into a single-column list with 16px row gaps."
Icon & Asset Placement
"Search the Tabler icon library for a 'settings' outline icon and place it in the top-right corner of the application bar."
"Replace the placeholder circles next to the username labels with user avatar icons from the Lucide collection."
Structural Layout Shifts & Visual QA
"Shift the page footer down by 120px to make room for an email newsletter subscription block above it."
"Add a new page named 'Account Settings' with sub-tabs for 'General', 'Security', and 'Billing'."
"Inspect the current canvas preview for contrast issues or overlapping elements and adjust misaligned bounds."
MCP Tools Reference
Pencil exposes its internal API through 5 catalog modules:
Additional collections and export templates can be installed through multiple sources:
Official Stencils & Templates Directory: Browse downloadable collections at pencil.evolus.vn/Stencils-Templates.html.
Community Stencils Repository: Community-contributed collections are hosted on GitHub at evolus/stencils-repository.
In-App Repository Browser: In Pencil, open Tools > Manage Collections to browse the online repository, install stencils directly from archive URLs, or load local .zip packages created with the Stencil Generator.
Development & Building from Source
Prerequisites
Node.js: Version 14 or higher (LTS recommended)
Package Manager: npm or yarn
Git
Installation
Clone the repository and check out the target branch:
git clone https://github.com/evolus/pencil.git
cd pencil
git checkout development
Install project dependencies:
yarn install
# or
npm install
Launch the development build:
yarn start
# or
npm start
For dev tools and inspection windows enabled:
npm run start:dev
Packaging & Distribution
To compile production bundles for your host platform:
# macOS (DMG, universal / arm64 / x64)
npm run dist:osx
# Windows (NSIS Installer)
npm run dist:win32
# Linux (deb, rpm, tar.gz)
npm run dist:linux
Output binaries are written to the dist/ directory.
Supported Platforms
macOS
macOS 10.9 and later.
Native builds available for Apple Silicon (arm64) and Intel (x64).
How does evolus/pencil compare to other Frontend projects?
evolus/pencil is tracked by TopGit in the Frontend category, with 9.9k GitHub stars and written in JavaScript. Browse the Frontend topic page on TopGit to compare it against similar projects by stars and activity.
Is evolus/pencil open source?
Yes — evolus/pencil ships under the GPL-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/evolus/pencil.
What else is in the Frontend space?
evolus/pencil is tracked by TopGit under the Frontend category, alongside 10 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is evolus/pencil?
evolus/pencil (evolus/pencil) is a JavaScript project on GitHub. From the project's own README: The Pencil Project's unique mission is to build a free and opensource tool for making diagrams and GUI prototyping that everyone can use.
Where do I read more about evolus/pencil?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/evolus/pencil is the definitive source.
Why is evolus/pencil categorized under Frontend?
TopGit places evolus/pencil in the Frontend category based on its GitHub topics and description (tagged: "drawing", "electron", "javascript"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Want a second opinion on pencil?
Ask an AI that can read this page — one click and you get its take on pencil.