windcraft
Health Gecti
- License — License: NOASSERTION
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 14 GitHub stars
Code Basarisiz
- network request — Outbound network request in packages/ai/providers.js
- exec() — Shell command execution in packages/core/animation-triggers.js
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Design in Tailwind. Keep it as code. A visual design editor where every click writes real Tailwind HTML.
Design in Tailwind. Keep it as code.
A visual design editor where every click writes real Tailwind HTML, with a library of 360 Tailwind components and pages.
Try it live · Get started · Wiki · npm · MCP · Contribute
Contents
What it is · Documentation · Screenshots · What you can do · Get started · How it is built · Status · Roadmap · Contributing · License
What it is
Windcraft is an editor for web pages where the page is plain HTML with Tailwind classes, and every control reads and writes those classes. Make the padding bigger and p-4 becomes p-6. Pick a colour and bg-rose-500 changes. Edit the code and the design follows; edit the design and the code follows.
There is no export step and no Windcraft-only format. What you see in the editor is the HTML you ship, so you can paste it into a codebase or hand it to a coding agent as it is.
Windcraft also comes with a library of 360 Tailwind designs: 350 components and 10 full pages, in categories such as pricing, hero sections, authentication, tables, charts, forms and footers. Every one is plain HTML with Tailwind classes. Copy it as it is, or open it in the editor and change it. Through the MCP server, Claude, Claude Code and Cursor can search the library, use a design in your project, and save a new one back ("save to library").
You can start from a blank page, from a Figma design (with a plugin that runs on your computer), or from a description (with Claude or a local model).
Documentation
The Windcraft wiki has the guides:
| Page | What is in it |
|---|---|
| Getting Started | Every way in, and your first five minutes |
| Using the Editor | Selecting, dragging, screen sizes, handles, the Properties panel |
| Embedding the Editor (npm) | startEditor, mountEditor, embedEditor and their options |
| MCP Server | Connect Claude, Claude Code or Cursor, what to ask, the tool list |
| Figma Plugin | Install, what it converts, what it does not |
| Self-Hosting | Run the full app, environment variables |
| Architecture | Packages, the sandboxed frame, how a drag works |
| Contributing and Reviews | How to contribute and how pull requests are reviewed |
| FAQ and Troubleshooting | Common problems |
| Roadmap and Status | What is solid, what is new, where to help |
Screenshots
Select anything. The Properties panel shows its Tailwind classes, and the code panel highlights the exact element.
Click the screenshot to try the editor in your browser, with nothing to install.
Interactions. Pick a button and say what it does: show or hide something, change classes, scroll, go to another frame. The arrow shows what it acts on. |
Animations. A preset library, a keyframe editor and scroll effects. The keyframes go into your Tailwind config. |
Your Tailwind config. Edit tailwind.config.js (Tailwind 3) or global.css (Tailwind 4), with plugins. It applies as you type.
|
A library of 360 Tailwind components and pages. Browse by category, copy the HTML, or open any design in the editor. |
What you can do
- Start from a library. 360 Tailwind components and pages (350 components, 10 pages), all plain HTML. Copy one, or open it in the editor. With the MCP server, Claude or Cursor can search it, use a design in your project, and save new ones to it.
- Edit visually. Select, move, resize, align, group, copy and paste. Draw frames, shapes, text, images and buttons. Drag to rearrange. Edits are written for the device you are editing (Mobile plain, Tablet
md:, Desktoplg:). - Work with the code. A Properties panel where every field is a Tailwind class, edited at its source, with breakpoints and states. A code panel with HTML, CSS, JS and Config tabs. Paste HTML from anywhere.
- Make it respond. Interactions (click or hover to show, hide, change classes, scroll, copy, go to another frame), one-click Tabs and Modal, animations, scroll-linked effects, text effects, SVG drawing.
- Bring things in. A free Figma plugin (no LLM, no network). Or describe a page and let Claude or a local model draft it.
- Connect and share. An MCP server for Claude, Claude Code and Cursor. Projects with their own look, share links, a full-screen prototype, export to HTML, React, Vue or Svelte, version history.
Get started
| I want to... | Use |
|---|---|
| Try it now | The live editor |
| Put the editor in my own site or app | npm: windcraft-editor |
| Let Claude, Claude Code or Cursor build pages | The MCP server |
| Turn a Figma design into Tailwind | The Figma plugin |
| Run my own copy | Self-host |
| Hack on the editor | Run it locally, no database |
Online
Open https://windcraft.swapniljadhav.com/. Nothing to install.
npm: windcraft-editor
npm install windcraft-editor
Serve node_modules/windcraft-editor as static files and import from it. No bundler or backend is needed.
import { startEditor } from "/windcraft/editor/index.js";
startEditor(document.getElementById("root"), { html: "<h1>Hello</h1>" });
| Function | Use it when |
|---|---|
startEditor(root, options) |
The editor is the whole page. Designs are saved in the browser. |
mountEditor(root, options) |
You load and save on your own server (give it a few host functions). |
embedEditor(root, options) |
The editor lives in one box of a page, in an iframe. |
Options, host functions and onChange are in the full guide.
MCP: Claude, Claude Code, Cursor
Windcraft runs an MCP server at your address plus /mcp (for the live site: https://windcraft.swapniljadhav.com/mcp).
| Client | How to connect |
|---|---|
| Claude (claude.ai) | Settings → Connectors → Add custom connector → paste the address → sign in to Windcraft → Allow. |
| Claude Code | Create a token on the Connect page (/connect), then claude mcp add --transport http tailwind-library <address> --header "Authorization: Bearer <token>" |
| Cursor and others | Add an HTTP server with the address and the header Authorization: Bearer <token>. |
Then ask: "Read my design guide, then build a settings page that matches", "Search my library for a pricing table and use it", or "Save this page to my Windcraft library." The MCP guide has the tool list.
Figma plugin
Install it from the Figma Community. It converts a selection to HTML and Tailwind on your computer, with no LLM and no network. To build it from source, see packages/figma.
Self-host the full app
Accounts, projects, the gallery, AI and MCP. You need Node.js 18+ and MongoDB (local or Atlas).
git clone https://github.com/Tolaj/windcraft.git
cd windcraft
npm install
cp .env.example .env # fill in MONGO_URI and SESSION_SECRET at least
npm run dev # http://localhost:3000
MONGO_URI and SESSION_SECRET are required. ANTHROPIC_API_KEY or LLM_URL turns on AI, and PUBLIC_URL lets Claude on the web reach your MCP server. .env.example lists the rest. For production use npm start; a vercel.json is included.
Run the editor locally (no database)
git clone https://github.com/Tolaj/windcraft.git
cd windcraft
npm install
npm run demo # http://localhost:4000/editor/demo/
How it is built
A monorepo of small packages around a Node app.
| Package | What it does |
|---|---|
windcraft-editor |
The visual editor (on npm). Host-agnostic. |
@windcraft/core |
The Tailwind logic as pure functions with tests. |
@windcraft/figma |
The Figma to Tailwind converter and plugin. Fixed rules, no LLM. |
@windcraft/mcp |
The MCP protocol for Express. |
@windcraft/ai |
Provider-neutral AI generation (Anthropic and OpenAI-compatible). |
src/ |
The app: Express 5, Handlebars, MongoDB. |
Stack: Node.js · Express 5 · Handlebars · MongoDB · Tailwind CSS · CodeMirror 6 · Anthropic SDK.
npm test runs the unit tests, npm run e2e the browser tests (they need MongoDB and Chrome), npm run typecheck the types. CONTRIBUTING.md has the repo map.
Status
Windcraft is under active development.
- Solid: the Properties panel, the code panel, selection and layers, the Figma converter's basic rules, projects and sharing.
- Newer: Interactions, animations, the Tailwind config tab, and dragging to rearrange. They are tried in Chrome only. Safari, Firefox and touch are untried, and big pages have not been timed.
Roadmap
- Figma converter: constraints, lists, image crop, and responsive output.
- Components and variants as first-class Windcraft components.
- A steadier drag in more browsers and on large pages.
Contributing
Windcraft is MIT licensed and open to everyone. You do not need to ask first.
- Fork the repo,
npm install, andnpm run demoto see your change. - Branch and keep the pull request small and about one thing.
- Check with
npm testandnpm run typecheck. A bug fix inpackages/coreor the Figma converter should come with a test that fails without it. - Open a pull request into
mainand say what you changed and how you checked it.
CONTRIBUTING.md and the wiki's Contributing and Reviews explain how reviews work. For questions, bugs and ideas, open an issue with the steps, what you expected, what happened and your browser.
License
MIT © 2026 Swapnil Jadhav. Third-party code keeps its own licenses: THIRD_PARTY_LICENSES.md.
Built by Swapnil Jadhav.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi
