nudg
Describe UI motion in a JSON file your AI can edit and a validator can check
- Pricing
- Open source
- Platforms
- CLI, Web, iOS
- Runs
- Locally
- Version
- 1.12.0
- Listing updated
- 3 days ago
About nudg
nudg is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
nudg stores an interaction (its states, the events moving between them and the springs or gestures in between) in a small .nudg.json file beside a component. An AI coding tool edits the file, nudg validates the edit, and a small runtime plays it. The README compares the file to sheet music, runtimes to performance rules, the AI to an arranger and the developer to a director.
TypeScript, Swift and Kotlin runtimes play the same compiled program the same way, checked by a shared conformance suite, so one motion file serves web, iOS and Android. The nudg_compare tool plays two versions under the same tap and says whether a person would notice the change before showing before-and-after frames side by side. A live demo has 49 examples and a playground whose validator hints at misspelled keys.
Install
Run in a terminal
claude mcp add nudg -- npx -y @nudg/coreAdd to claude_desktop_config.json
{
"mcpServers": {
"nudg": {
"command": "npx",
"args": [
"-y",
"@nudg/core"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nudg": {
"command": "npx",
"args": [
"-y",
"@nudg/core"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nudg": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nudg/core"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nudg": {
"command": "npx",
"args": [
"-y",
"@nudg/core"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nudg": {
"command": "npx",
"args": [
"-y",
"@nudg/core"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- nudg_compare
- Plays two versions of an interaction and reports how noticeable the difference is.
What it does
- Plain JSON motion
- States, events and transitions in one file.
- Validation
- Checks AI edits and hints at misspelled keys.
- Cross-platform runtimes
- TypeScript, Swift and Kotlin.
- Before/after comparison
- Reports whether a change is noticeable.
- Live playground
- 49 examples to edit and run.
Good for
- Ask an AI to make a bounce springier
- Compare two motion variants
- Share one interaction spec across platforms
- Check a gesture definition before shipping
Pricing
Open source
Open source; no paid plan listed
Prices change. Check seukwoo.github.io before you buy.
nudg FAQ
Which platforms are supported?
Web, iOS and Android through TypeScript, Swift and Kotlin runtimes.
How is the package installed?
Via npm as @nudg/core.
Can I try it first?
Yes, the demo and playground.
What does the compare tool do?
Plays both versions and describes how noticeable the difference is.
Is nudg free?
Yes. nudg is open source, so you can use and self-host it for free.
How do I add nudg to Claude Code?
Run this command in your terminal: claude mcp add nudg -- npx -y @nudg/core
What are the best alternatives to nudg?
The closest alternatives to nudg are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to nudg

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory