Apotheosis UX is a modern, TypeScript-first component ecosystem engineered to power next generation full-stack web applications. It proffers a comprehensive Neumorphic design system, equipping developers with sleek, accessible, and production-ready primitives to craft highly tactile, minimalist, and ultramodern user interfaces. \n\nBeyond aesthetics, Apotheosis UX pioneers an AI-ready architecture—tailored for agent-driven experiences like RAG pipelines, conversational interfaces & generative UI. Built for seamless integration into AI coding environments via the Model Context Protocol (MCP).
\n\n## Private Monorepository (Request Access) 🔐\nAccess to the core source code is currently restricted.\nApotheosis UX Repository\n\n## Quick Start\nRead the official Apotheosis UX documentation for comprehensive guides on neumorphic design system, React primitives, backend component templates and MCP server deployment.
\n\n## Usage\n\n#### Install Apotheosis UX Component Library\nFor standard React frontend application project:
\n\n```bash\nnpm install @emeraldemperaur/apotheosis-ux\n```\n\n#### Connect with AI Developer via MCP Server \nApotheosis UX proffers an official Model Context Protocol server. This allows AI IDEs to directly read the component registry, type definitions, and backend blueprints to facilitate a hallucination-resistant developer experience.
\n\n##### Option A: Remote Enterprise Connection (Frictionless Authentication)\nFor subscribed users, add the managed endpoint to the AI IDE's MCP configuration. Apotheosis UX utilizes Streamable HTTP in tandem with dynamic Clerk OAuth. IDE will automatically prompt a secure browser login with no API keys required.
\n\n```json\n{\n \"mcpServers\": {\n \"mito-ui\": {\n \"url\": \"https://apotheosis-ux.onrender.com/mcp\",\n \"transport\": \"http\"\n }\n }\n}\n```\n\n##### Option B: Local CLI Connection (Authentication Key)\nInstall the CLI package globally to run the server locally.
\n\n```bash\nnpm install -g @emeraldemperaur/mito-ui-mcp\n```\n\nConfigure the AI IDE to launch Apotheosis UX MCP via stdio:
Apotheosis UX ecosystem is structured as a scalable monorepo:
\n@emeraldemperaur/apotheosis-ux: Named Exports React UI component library.@emeraldemperaur/apotheosis-ux: Scalable backend service components & architectural templates.@emeraldemperaur/apotheosis-ux-mcp: Dual-transport enabled AI context server via remote Streamable HTTP and localhost StdioServerTransport.Ensure you are using pnpm as the package manager for this workspace.
To release updates to the NPM registry, authenticate and use PNPM workspace filters:
\n\n##### NPM Authenticate\n\n```bash\nnpm login\n```\n\n##### Publish using PNPM Filters\n```bash\npnpm --filter package1name publish --access public\npnpm --filter package2name publish --access public\n```\ne.g.
\n\n```bash\nnpm login\npnpm --filter @emeraldemperaur/apotheosis-ux publish --access public\npnpm --filter @emeraldemperaur/apotheosis-ux-mcp publish --access public\n```\n\n#### Init Husky\n```bash\n# Install Husky in tandem with lint-staged at the workspace root\npnpm add -wD husky lint-staged\n\n# Initialize Husky in workspace root to create .husky folder and update package.json scripts\npnpm exec husky init\n```\nConfigure pre-commit hook in .husky/pre-commit to run lint-staged.