Watermelon UI

Name: Watermelon UI
Author: watermelon

@watermelonMCP server · External

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

UI designv2.0.0MITTypeScript

Freeno charge per call

One address for any MCP client. No sign-in needed on this server.

What it does

6 read2 other

Grouped by tool name.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Tools

8 · grouped by tool name · checked 1 Oct 2026

Read · 6Look things up

search
get_component
get_inspiration
list_categories
list_catalog_entries
get_catalog_entry

Other · 2Neither hinted nor named

compose_page
catalog_summary

Try it in the Inspector

README3 min readView on GitHub

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

bash

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.

bash

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:

bash

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:

Read CONTRIBUTING.md.
Pick the content type you want to add or improve.
Follow the matching folder pattern in src/data/contents.
Run bun run lint and bun run build.
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.