Skip to content

Commit b39ace2

Browse files
committed
featL new asset images for mcp, fix image paths
1 parent 635f78f commit b39ace2

25 files changed

+65
-77
lines changed

README.md

Lines changed: 65 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<p align="center">
22
<picture>
3-
<source media="(prefers-color-scheme: dark)" srcset="assets/hero-dark.svg">
4-
<source media="(prefers-color-scheme: light)" srcset="assets/hero-light.svg">
5-
<img alt="Shows a screenshot of the extension panel." src="assets/hero-light.svg" width="540" height="200">
3+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/hero-dark.svg">
4+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/hero-light.svg">
5+
<img alt="Shows a screenshot of the extension panel." src="packages/extension/assets/hero-light.svg" width="540" height="200">
66
</picture>
77
</p>
88

@@ -20,9 +20,9 @@
2020

2121
<p align="center">
2222
<picture>
23-
<source media="(prefers-color-scheme: dark)" srcset="assets/code-dark.png">
24-
<source media="(prefers-color-scheme: light)" srcset="assets/code-light.png">
25-
<img alt="Shows a screenshot of the extension panel." src="assets/code-light.png" width="720">
23+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/code-dark.png">
24+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/code-light.png">
25+
<img alt="Shows a screenshot of the extension panel." src="packages/extension/assets/code-light.png" width="720">
2626
</picture>
2727
</p>
2828

@@ -33,17 +33,17 @@
3333
### Inspect CSS code
3434

3535
<picture>
36-
<source media="(prefers-color-scheme: dark)" srcset="assets/code-dark.png">
37-
<source media="(prefers-color-scheme: light)" srcset="assets/code-light.png">
38-
<img alt="Shows the CSS and JavaScript code for a selected element." src="assets/code-light.png" width="720">
36+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/code-dark.png">
37+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/code-light.png">
38+
<img alt="Shows the CSS and JavaScript code for a selected element." src="packages/extension/assets/code-light.png" width="720">
3939
</picture>
4040

4141
Select any element, and you can obtain the CSS code through the plugin's Code panel. In addition to standard CSS code, TemPad Dev also provides styles in the form of JavaScript objects, making it convenient for use in JSX and similar scenarios.
4242

4343
<picture>
44-
<source media="(prefers-color-scheme: dark)" srcset="assets/unit-dark.png">
45-
<source media="(prefers-color-scheme: light)" srcset="assets/unit-light.png">
46-
<img alt="Shows units and root font size settings in preferences." src="assets/unit-light.png" width="720">
44+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/unit-dark.png">
45+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/unit-light.png">
46+
<img alt="Shows units and root font size settings in preferences." src="packages/extension/assets/unit-light.png" width="720">
4747
</picture>
4848

4949
You can configure CSS units and root font size to convert `px` dimensions in CSS to `rem` units. You can also apply a `scale` factor to scale `px` values according to your handoff requirements.
@@ -54,29 +54,29 @@ You can configure CSS units and root font size to convert `px` dimensions in CSS
5454
### Deep select mode
5555

5656
<picture>
57-
<source media="(prefers-color-scheme: dark)" srcset="assets/deep-dark.png">
58-
<source media="(prefers-color-scheme: light)" srcset="assets/deep-light.png">
59-
<img alt="Shows the deep select mode in preferences." src="assets/deep-light.png" width="720">
57+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/deep-dark.png">
58+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/deep-light.png">
59+
<img alt="Shows the deep select mode in preferences." src="packages/extension/assets/deep-light.png" width="720">
6060
</picture>
6161

6262
In Figma's read-only view, selecting nodes requires double-clicking to drill down, and it often takes repeated double-clicks to select the lowest-level node. Although Figma offers a <kbd>⌘</kbd> + click shortcut, many users are unaware of this feature and need to perform extra key operations each time. Therefore, TemPad Dev provides a deep select mode in preferences.
6363

6464
### Measure to selection mode
6565

6666
<picture>
67-
<source media="(prefers-color-scheme: dark)" srcset="assets/measure-dark.png">
68-
<source media="(prefers-color-scheme: light)" srcset="assets/measure-light.png">
69-
<img alt="Shows the measure to selection mode in preferences." src="assets/measure-light.png" width="720">
67+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/measure-dark.png">
68+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/measure-light.png">
69+
<img alt="Shows the measure to selection mode in preferences." src="packages/extension/assets/measure-light.png" width="720">
7070
</picture>
7171

7272
In Figma's read-only view, you need to hold <kbd>⌥</kbd> and move the cursor to display the spacing between other nodes and the selected node. For similar reasons to the deep select mode, TemPad Dev provides a measure to selection mode in preferences.
7373

7474
### Scroll selection into view
7575

7676
<picture>
77-
<source media="(prefers-color-scheme: dark)" srcset="assets/scroll-dark.png">
78-
<source media="(prefers-color-scheme: light)" srcset="assets/scroll-light.png">
79-
<img alt="Shows the scroll selection into view feature." src="assets/scroll-light.png" width="720">
77+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/scroll-dark.png">
78+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/scroll-light.png">
79+
<img alt="Shows the scroll selection into view feature." src="packages/extension/assets/scroll-light.png" width="720">
8080
</picture>
8181

8282
When you hover over a node name section in TemPad Dev's inspect panel, a corresponding button appears. Clicking it will scroll the current selection to the center of the Figma viewport. Figma has a similar <kbd>⇧2</kbd> shortcut, but it zooms in to fill the viewport, which often doesn't meet the needs. Figma actually exposes an interface in the plugin API to move and zoom to 100%, so we also provide this capability as a supplement.
@@ -86,9 +86,9 @@ When you hover over a node name section in TemPad Dev's inspect panel, a corresp
8686
### Plugins
8787

8888
<picture>
89-
<source media="(prefers-color-scheme: dark)" srcset="assets/plugins-dark.png">
90-
<source media="(prefers-color-scheme: light)" srcset="assets/plugins-light.png">
91-
<img alt="Shows the plugins section in preferences." src="assets/plugins-light.png" width="720">
89+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/plugins-dark.png">
90+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/plugins-light.png">
91+
<img alt="Shows the plugins section in preferences." src="packages/extension/assets/plugins-light.png" width="720">
9292
</picture>
9393

9494
Plugins allow you to customize the built-in code output or add custom code blocks.
@@ -196,9 +196,15 @@ TemPad Dev ships an [MCP](https://modelcontextprotocol.io/) server so agents/IDE
196196

197197
### Setup guide
198198

199-
1. Requirements: Node.js 18+ and TemPad Dev running in a Figma tab.
200-
2. In TemPad Dev, open **Preferences → MCP server** and toggle **Enable MCP server**.
201-
3. Use the quick actions in Preferences to install/connect, or add the server manually to your MCP client as a stdio command:
199+
<picture>
200+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/mcp-config-dark.png">
201+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/mcp-config-light.png">
202+
<img alt="TemPad Dev MCP preferences panel." src="packages/extension/assets/mcp-config-light.png" width="480">
203+
</picture>
204+
205+
1. **Requirements**: Node.js 18+ and TemPad Dev running in a Figma tab.
206+
2. In TemPad Dev, open **Preferences → MCP server**, then enable **Enable MCP server**.
207+
3. Install and connect using the quick actions in Preferences, or add the server manually to your MCP client as a stdio command:
202208

203209
```json
204210
{
@@ -211,9 +217,39 @@ TemPad Dev ships an [MCP](https://modelcontextprotocol.io/) server so agents/IDE
211217
}
212218
```
213219

214-
For CLI-style installers, the equivalent commands are `claude mcp add --transport stdio "TemPad Dev" -- npx -y @tempad-dev/mcp@latest` or `codex mcp add "TemPad Dev" -- npx -y @tempad-dev/mcp@latest`.
220+
If your client uses a CLI installer, these are equivalent:
221+
- `claude mcp add --transport stdio "TemPad Dev" -- npx -y @tempad-dev/mcp@latest`
222+
- `codex mcp add "TemPad Dev" -- npx -y @tempad-dev/mcp@latest`
223+
224+
4. Keep the TemPad Dev tab active while using MCP. If you have multiple Figma files open (and therefore multiple TemPad Dev instances), click the MCP badge in the TemPad Dev panel to activate the correct file for your agent.
225+
226+
### MCP connection status
227+
228+
When MCP is enabled, a badge appears in the TemPad Dev panel title bar showing the current connection status:
229+
230+
- **Unavailable**: The local MCP server is not configured or not running.
231+
232+
<picture>
233+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/mcp-unavailable-dark.png">
234+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/mcp-unavailable-light.png">
235+
<img alt="MCP status badge showing Unavailable." src="packages/extension/assets/mcp-unavailable-light.png" width="720">
236+
</picture>
237+
238+
- **Inactive**: TemPad Dev is connected to a local MCP server, but this tab is not currently active because multiple Figma tabs are open. Click the badge to activate MCP for this tab (this deactivates MCP in other tabs).
215239

216-
4. Keep the TemPad Dev tab active while using MCP. If you have multiple Figma files (and thus multiple TemPad Dev extensions) open, click the MCP badge in the TemPad Dev panel to activate the correct file for your agent.
240+
<picture>
241+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/mcp-inactive-dark.png">
242+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/mcp-inactive-light.png">
243+
<img alt="MCP status badge showing Inactive." src="packages/extension/assets/mcp-inactive-light.png" width="720">
244+
</picture>
245+
246+
- **Active**: The MCP server is running, and this tab is active and ready to respond to MCP tool calls.
247+
248+
<picture>
249+
<source media="(prefers-color-scheme: dark)" srcset="packages/extension/assets/mcp-active-dark.png">
250+
<source media="(prefers-color-scheme: light)" srcset="packages/extension/assets/mcp-active-light.png">
251+
<img alt="MCP status badge showing Active." src="packages/extension/assets/mcp-active-light.png" width="720">
252+
</picture>
217253

218254
### Configuration
219255

@@ -262,24 +298,14 @@ Except for the above-mentioned features, others are mostly consistent with the s
262298
<details>
263299
<summary><h3>Compatibility Updates</h3></summary>
264300

265-
<picture>
266-
<source media="(prefers-color-scheme: dark)" srcset="assets/duplicate-dark.png">
267-
<source media="(prefers-color-scheme: light)" srcset="assets/duplicate-light.png">
268-
<img align="right" alt="Choose “Duplicate to your drafts” to ensure standard mode instead of quirks mode." src="assets/duplicate-light.png" width="360">
269-
</picture>
270-
271301
**2025.04.01**: Figma removed the `window.DebuggingHelpers.logSelected` API, which was used to extract style data. As a result, Quirks mode is no longer usable.
272302

273303
**2024.11.04**: TemPad Dev now managed to bring back the `window.figma` API under view-only mode. But we still cannot guarantee the long-term validity of this feature. If Figma removes the related interface again, this mode will also become unavailable.
274304

275305
**2024.04.08**: TemPad Dev successfully retrieved most style information using currently unblocked debug interfaces, providing a new [Quirks Mode](#quirks-mode). This mode does not rely on `window.figma` but instead parses debug logs to generate style code, with slight differences from the standard mode.
276306

277-
**2024.04.03**: The Figma team adjusted the expected time from "in the coming weeks" to "in the coming months", effectively shelving the issue.
278-
279307
**2024.03.20**: After we posted complaints on the Figma Community Forum, the Figma team stated that they would reinstate the `window.figma` interface in view-only mode in the coming weeks. You can track the progress of this issue on this [thread](https://forum.figma.com/t/figma-removed-window-figma-on-view-only-pages-today/67292).
280308

281-
**2024.03.19**: Figma removed the `window.figma` interface in view-only mode. As a result, we can no longer seamlessly view information and code for Figma elements in view-only mode.
282-
283309
</details>
284310

285311
</details>
1.39 KB
Loading
2 KB
Loading
3.92 KB
Loading
4.31 KB
Loading
-15.3 KB
Binary file not shown.
-16.6 KB
Binary file not shown.
5.88 KB
Loading
6.07 KB
Loading
9.51 KB
Loading

0 commit comments

Comments
 (0)