AwesomeUCP

Showcase website for Universal Commerce Protocol tools and resources.

A beautiful single-page site showcasing the AwesomeUCP ecosystem, including UCP Doctor and UCP Merchants directory.

Features

• Single Page Showcase: Clean, modern design highlighting all UCP tools
• Theme Switching: Light, dark, and system theme support with persistent preferences
• Responsive Design: Mobile-first design that works on all devices
• Project Cards: Detailed cards for UCP Doctor and UCP Merchants with features and links
• Consistent Design Language: Matches the design system of other UCP projects

Tech Stack

• Next.js 16 - React framework with App Router
• React 19 - Latest React with server components
• TypeScript - Type-safe development
• Tailwind CSS v4 - Modern utility-first styling
• Phosphor Icons - Beautiful icon system

Quick Start

# Install dependencies
bun install

# Run development server
bun run dev
# Open http://localhost:3000

# Build for production
bun run build

# Start production server
bun run start

Project Structure

awesomeucp-web/
├── app/
│   ├── layout.tsx           # Root layout with theme support
│   ├── page.tsx             # Main showcase page
│   └── globals.css          # Global styles
├── components/
│   ├── layout/
│   │   └── Header.tsx       # Sticky header with navigation
│   ├── theme/
│   │   ├── ThemeProvider.tsx  # Theme context provider
│   │   └── ThemeSwitcher.tsx  # Theme toggle component
│   └── ui/
│       ├── Button.tsx       # Reusable button component
│       ├── Card.tsx         # Card component
│       └── Badge.tsx        # Badge component
└── package.json

Design System

The site follows the AwesomeUCP design language:

• Colors: Zinc-based palette with blue/purple accents
• Typography: Geist Sans and Geist Mono fonts
• Theme: Light, dark, and system theme support
• Icons: Phosphor Icons with duotone, fill, and regular weights
• Layout: Clean, modern, with sticky headers and smooth transitions

Showcased Projects

UCP Doctor

Diagnostic tool for validating Universal Commerce Protocol implementations. Features 20 comprehensive checks, real-time streaming, and auto-generated schemas.

• Website: doctor.awesomeucp.com
• GitHub: github.com/awesomeucp/ucp-doctor

UCP Merchants

Directory of UCP-enabled merchants for AI commerce. Browse verified merchants, access public API, and submit your own store.

• Website: merchants.awesomeucp.com
• GitHub: github.com/awesomeucp/merchants

Contributing

We welcome contributions! Please read our Contributing Guide and Code of Conduct before submitting a PR.

Security

For security concerns, please review our Security Policy.

License

Apache License 2.0 - see LICENSE file for details.

Links

• UCP Documentation: ucp.dev
• GitHub Organization: github.com/awesomeucp

---

Part of the Universal Commerce Protocol ecosystem.