Repo of the Day
Tolaj/windcraft
Published: Nov 16, 2026
Open repository ↗Design in Tailwind. Keep it as code. A visual design editor where every click writes real Tailwind HTML
Summary
Windcraft is a visual editor for web pages built with plain HTML and Tailwind CSS. Visual changes update the underlying Tailwind classes, and code changes update the design, so engineers can use the editor without adopting a Windcraft-only page format. The repository also includes a component library, an npm editor package, an MCP server, a Figma converter, and optional AI-backed page generation.
What it is useful for
Windcraft is useful when an engineer wants visual feedback without giving up ordinary HTML. For example, changing padding can turn p-4 into p-6, while choosing a color can replace bg-rose-500. Responsive edits are written for the current screen: plain classes on mobile, md: on tablet, and lg: on desktop.
The Properties and code panels cover HTML, CSS, JavaScript, and Tailwind configuration. The library includes pricing, hero, authentication, table, chart, and form examples that can be copied or opened directly in the editor.
For tool-assisted workflows, the MCP server lets Claude, Claude Code, and Cursor search the library and save designs back. The Figma plugin converts a selected frame using fixed rules, without an LLM or network connection.
How engineers can use it
The quickest local check does not require a database. The README documents:
git clone https://github.com/Tolaj/windcraft.git
cd windcraft
npm install
npm run demo
The editor is then available at http://localhost:4000/editor/demo/.
To embed it in another site or application, install the published package:
npm install windcraft-editor
Serve node_modules/windcraft-editor as static files; no bundler or backend is required. A documented starting point is:
import { startEditor } from "/windcraft/editor/index.js";
startEditor(document.getElementById("root"), { html: "<h1>Hello</h1>" });
Use startEditor for a full-page editor with browser-based saving, mountEditor when the host application handles loading and saving through its own server functions, or embedEditor to place the editor in an iframe. The README points to packages/editor/README.md for the available options.
For the complete application, including accounts, projects, the gallery, AI, and MCP, Node.js 18+ and MongoDB are required. Set at least MONGO_URI and SESSION_SECRET in .env; ANTHROPIC_API_KEY or LLM_URL enables AI, while PUBLIC_URL allows Claude on the web to reach the MCP server.
Run npm test and npm run typecheck before submitting changes. Windcraft is actively developed: interactions, animations, config editing, and dragging are currently tried in Chrome only, while steadier dragging, first-class components and variants, and richer Figma conversion remain roadmap work.