Sora UI

A fully animated, open-source component distribution built with React, TypeScript, Tailwind CSS, and Motion.

Documentation

Visit ui.soralabs.studio to view the documentation.

Local development

bun install
bun run dev:www    # docs site only → http://localhost:3000
# or
bun dev            # run all apps (Next.js docs + xmcp)

No .env file is required to browse docs, blog, the catalog, or use Ask AI locally. Copy apps/www/.env.example only when you need optional features:

Feature	Variables
Sign-in (Google / GitHub)	DATABASE_URL, BETTER_AUTH_SECRET, OAuth client ids/secrets
Bookmarks	DATABASE_URL + session (above)
Redis rate limits / cache	UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN
Better Auth Sentinel	BETTER_AUTH_API_KEY, NEXT_PUBLIC_BETTER_AUTH_IDENTIFY_URL
Custom Ask AI endpoint	AI_SEARCH_CHAT_URL (defaults to the public docs search instance)
Sentry	NEXT_PUBLIC_SENTRY_DSN

Production deployments must set BETTER_AUTH_SECRET and DATABASE_URL at minimum.

MCP Server

Sora UI includes an official Model Context Protocol (MCP) server built with xmcp under apps/xmcp. It enables AI assistants (Cursor, Claude Desktop, Claude Code, etc.) to search documentation, browse sections, and install components:

# Run MCP server in development mode
cd apps/xmcp && bun run dev

# Build HTTP and STDIO bundles
cd apps/xmcp && bun run build

See the MCP Documentation or apps/xmcp/README.md for full configuration details.

Contributing

Visit our contributing guide to learn how to contribute.

Adding a documented component (registry + docs preview flow): see apps/www/registry/README.md.

Code of Conduct

This project follows a Code of Conduct to help create a welcoming community. Please read CODE_OF_CONDUCT.md before contributing.

License

Licensed under the MIT license.