English Français العربية

Watermelon UI

Official registry Search and web

Search free React, Tailwind, and shadcn components, blocks, and dashboards; get installable source.

Source code Website Documentation

What can you do with Watermelon UI?

  • renders the public Watermelon UI experience
  • loads content from MDX and colocated source files
  • previews components, blocks, dashboards, and templates
  • generates the sitemap and other search-friendly surfaces
  • gives contributors a structured way to publish new content
  • includes developer-facing AI and MCP discovery files

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http watermelon-ui 'https://mcp.watermelon.sh/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "watermelon-ui": {
            "type": "http",
            "url": "https://mcp.watermelon.sh/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Watermelon Platform
  2. What This Repo Does
  3. Stack
  4. Quick Start
  5. Content Model
  6. Installable Components
  7. Contributing
  8. AI And Developer Surfaces
  9. Repository Health
  10. Star History
  11. Support The Work
  12. Where Sponsor Support Goes

Watermelon Platform

The open-source platform behind ui.watermelon.sh.

Free for the community. Supported by people and teams who want Watermelon to keep getting better.

This repo powers the browsing experience for Watermelon components, animated UI, blocks, dashboards, and templates. It is where discovery, previews, docs, SEO pages, and contributor-facing content all come together.

What This Repo Does

  • renders the public Watermelon UI experience
  • loads content from MDX and colocated source files
  • previews components, blocks, dashboards, and templates
  • generates the sitemap and other search-friendly surfaces
  • gives contributors a structured way to publish new content
  • includes developer-facing AI and MCP discovery files

Stack

  • React 19
  • TypeScript
  • Vite
  • Tailwind CSS 4
  • Motion
  • React Router
  • Bun for the preferred local workflow

Quick Start

git clone https://github.com/WatermelonCorp/watermelon-platform.git
cd watermelon-platform
bun install
bun run dev

Useful commands:

  • bun run dev: start the local app
  • bun run build: generate the sitemap, typecheck, and build production assets
  • bun run lint: run ESLint
  • bun run preview: preview the production build locally
  • bun run deploy: build and deploy
  • bun run mcp: start the local Watermelon MCP server over stdio
  • bun run mcp:dev: run the hosted MCP Worker locally
  • bun run mcp:deploy: deploy the hosted MCP Worker to Cloudflare
  • bun run generate:shadcn-registry: generate installable shadcn registry JSON

Public machine-readable endpoints:

  • /llms.txt
  • /openapi.json
  • /api/docs
  • /api/catalog/summary
  • /api/catalog/entries?kind=blocks

Content Model

Most public content is file-based and lives in src/data/contents.

  • animated-components/: animated component source folders
  • registry/: MDX metadata for animated component entries
  • components/: UI component category configs
  • blocks/: block content and previews
  • dashboards/: dashboard entries and demos
  • templates/: template entries and demos

Routes are wired in src/components/layout/app-routes.tsx, and the sitemap is generated from the same content model in scripts/generate-sitemap.ts.

Installable Components

Watermelon components are distributed as copy-paste shadcn registry items, so the resulting code lives in the consuming project and remains fully editable.

npx shadcn@latest add https://registry.watermelon.sh/r/card-split-accordian.json

The registry is generated from the maintained animated component source during every platform build and includes the complete base-component collection.

Connect the hosted MCP server (no API key) to your AI client:

claude mcp add --transport http watermelon https://mcp.watermelon.sh/mcp
codex mcp add watermelon --url https://mcp.watermelon.sh/mcp

Contributing

The easiest way to contribute is to improve one thing at a time:

  1. Read CONTRIBUTING.md.
  2. Pick the content type you want to add or improve.
  3. Follow the matching folder pattern in src/data/contents.
  4. Run bun run lint and bun run build.
  5. Open a PR with screenshots for anything visual.

Docs, polish, accessibility fixes, demo improvements, and contributor experience changes are all valuable contributions here.

AI And Developer Surfaces

Watermelon includes a few machine-readable surfaces to help agents and tooling understand the project faster:

  • public/llms.txt
  • public/openapi.json
  • public/sitemap.xml
  • mcp/server.ts
  • mcp/worker.ts
  • wrangler.mcp.toml
  • worker/site.ts
  • skills/watermelon-ui/SKILL.md
  • .codex-plugin/plugin.json
  • .claude-plugin/plugin.json
  • .cursor-plugin/plugin.json

The hosted MCP endpoint lives at https://mcp.watermelon.sh/mcp and exposes 800+ source-backed examples through search, retrieval, inspiration, category, and page-composition tools.

The hosted Worker records aggregate initialize and tools/call event counts in Cloudflare Analytics Engine. It does not retain IP addresses, session IDs, prompts, tool arguments, or client-provided versions.

Repository Health

Star History

The chart is generated from the repository's own stargazer timeline. Maintainers can refresh it with bun run generate:star-history.

Support The Work

This platform is part of the free public Watermelon ecosystem. If it saves your team time, sponsorship helps us keep improving it for everyone.

  • use the GitHub Sponsor button when available
  • use the custom funding link configured for the org: watermelon.sh
  • star the repo and share it with other builders

Where Sponsor Support Goes

Support for this repo helps fund:

  • more free public components, dashboards, templates, and docs
  • better previews, discovery, search, and SEO improvements
  • bug fixes, accessibility work, and contributor experience cleanup
  • hosting, deployment, and ongoing maintenance

As of August 30, 2026, GitHub Sponsors for the WatermelonCorp org is not fully activated yet, so the funding links are the current support path.

Frequently asked questions

What is Watermelon UI?

Search free React, Tailwind, and shadcn components, blocks, and dashboards; get installable source.

How do I install Watermelon UI?

It runs as a remote server. In Claude Code: claude mcp add --transport http watermelon-ui 'https://mcp.watermelon.sh/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Watermelon UI need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Watermelon UI open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Watermelon UI?

It is published by WatermelonCorp. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.