Requirements & installation
HTML → Frames is two parts that work together: the Figma plugin you see, and a local render server that does the heavy lifting in a real headless browser. The plugin cannot import anything without the server running.
Requirements
| Requirement | |
|---|---|
| Figma | The Figma desktop app — development plugins can't load in the browser version |
| Editor | Figma Design files (not FigJam or Slides) |
| Browser engine | Chrome or Edge installed (the server finds either automatically) |
| OS | Windows (the bundled launcher is a .bat; the server itself is Node and runs anywhere) |
The distribution package is self-contained — it bundles its own Node runtime, so there is nothing else to install.
Install the server
- Extract the plugin package to a folder of your choice — don't run it from inside the zip archive.
- Double-click
start-server.bat. The first run installs its dependencies, then starts the server athttp://localhost:3847. Keep the console window open while you work; closing it stops the server.
Windows SmartScreen
The first launch may trigger a SmartScreen warning because the .bat is unsigned. Click More info ▸ Run anyway. Everything the script does is local — it starts a Node process on port 3847.
The launcher also frees port 3847 if a previous session left a process on it, so re-running the .bat is the universal "restart the server" move.
Install the plugin
- Open the Figma desktop app.
- Go to Plugins ▸ Development ▸ Import plugin from manifest…
- Select
manifest.jsonin the plugin folder. - Run Plugins ▸ Development ▸ HTML → Frames.
The plugin window opens with a server status pill at the top. Green Server connected means you're ready; red Server not running means the server isn't up yet — start it and click Check.
Install the Chrome extension (optional)
The HTML to Frames Capture extension lets you capture any element from a page in your own browser — including pages behind a login — and import it with one click. It lives in the extension folder of the package:
- Open
chrome://extensionsin Chrome. - Enable Developer mode (top right).
- Click Load unpacked and select the
extensionfolder.
How to use it is covered in Import a website URL.
Next
With everything green, do your first import.