{"id":44288498,"url":"https://github.com/uipath/apollo-ui","last_synced_at":"2026-05-04T22:03:04.368Z","repository":{"id":337702984,"uuid":"1089101830","full_name":"UiPath/apollo-ui","owner":"UiPath","description":"A design system by UiPath","archived":false,"fork":false,"pushed_at":"2026-04-23T04:17:44.000Z","size":72229,"stargazers_count":11,"open_issues_count":27,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-23T06:27:57.115Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://apollo-ux.vercel.app/","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UiPath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-03T22:16:38.000Z","updated_at":"2026-04-23T04:17:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"506d009b-b748-44ab-94f8-edec3fca49cf","html_url":"https://github.com/UiPath/apollo-ui","commit_stats":null,"previous_names":["uipath/apollo-ui"],"tags_count":351,"template":false,"template_full_name":null,"purl":"pkg:github/UiPath/apollo-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UiPath%2Fapollo-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UiPath%2Fapollo-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UiPath%2Fapollo-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UiPath%2Fapollo-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UiPath","download_url":"https://codeload.github.com/UiPath/apollo-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UiPath%2Fapollo-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32361477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-10T23:08:10.132Z","updated_at":"2026-04-28T01:00:53.012Z","avatar_url":"https://github.com/UiPath.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apollo v.4 Design System\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![pnpm](https://img.shields.io/badge/maintained%20with-pnpm-cc00ff.svg)](https://pnpm.io/)\n[![Turborepo](https://img.shields.io/badge/built%20with-Turborepo-ef4444.svg)](https://turbo.build/)\n\nApollo v.4 is UiPath's open-source design system for building consistent user experiences across all UiPath products.\n\n## Table of Contents\n- [✨ Features](#-features)\n- [📦 Package Dependency Graph](#-package-dependency-graph)\n- [📁 Repository Structure](#-repository-structure)\n- [📦 Packages](#-packages)\n  - [Core Foundation](#core-foundation)\n  - [Framework Implementations](#framework-implementations)\n  - [Web Components](#web-components)\n- [🎨 Live Demos](#-live-demos)\n- [📚 Documentation](#-documentation)\n- [🚀 Contributing](#-contributing)\n- [License](#license)\n\n## ✨ Features\n\n- 🎨 **Design Tokens** - 1300+ icons, comprehensive color system, typography, spacing\n- ⚛️ **React Components** - Built on Material UI with Apollo theming\n- 🎐 **Tailwind CSS** - Modern utility-first styling with shadcn/ui\n- 🌐 **Web Components** - Cross-framework components for maximum flexibility\n- 📘 **TypeScript** - Full type safety across all packages\n- 📚 **Storybook** - Interactive component documentation\n- 🚀 **Monorepo** - Efficient development with Turborepo and pnpm\n\n## 📦 Package Dependency Graph\n\n```mermaid\ngraph RL\n    React[\"@uipath/apollo-react\u003cbr/\u003eReact + Material UI\"] --\u003e|requires| Core[\"@uipath/apollo-core\u003cbr/\u003eDesign Tokens, Icons, Fonts\"]\n    Wind[\"@uipath/apollo-wind\u003cbr/\u003eTailwind + shadcn/ui\"] --\u003e|requires| Core\n    React --\u003e|requires| Wind\n    Chat[\"@uipath/ap-chat\u003cbr/\u003eChat Web Component\"] --\u003e|requires| React\n\n    style Core fill:#374151,stroke:#ef4444,stroke-width:3px,color:#fff\n    style React fill:#1e3a8a,stroke:#3b82f6,stroke-width:3px,color:#fff\n    style Wind fill:#164e63,stroke:#06b6d4,stroke-width:3px,color:#fff\n    style Chat fill:#064e3b,stroke:#10b981,stroke-width:3px,color:#fff\n```\n\n## 📁 Repository Structure\n\n```\napollo-ui/\n├── packages/              # Core + framework packages\n│   ├── apollo-core/       # 🎨 Design tokens, icons, fonts\n│   ├── apollo-react/      # ⚛️ Canvas components, chat, icons, MUI theme\n│   └── apollo-wind/       # 🎐 Tailwind + shadcn/ui\n│\n├── web-packages/          # Cross-framework web components\n│   └── ap-chat/           # 💬 Chat web component\n│\n└── apps/                  # Demo \u0026 development applications\n    ├── apollo-vertex/     # 🌟 Main Storybook hub\n    ├── storybook/         # 📚 Component documentation\n    └── react-playground/  # 🔬 React testing environment\n```\n\n## 📥 Installation\n\nAll Apollo packages are published to both **npm** and **GitHub Package Registry** for maximum accessibility.\n\n### For External Users (npm - Recommended)\n\nNo special configuration needed. Just install packages directly:\n\n```bash\nnpm install @uipath/apollo-react\n# or\nnpm install @uipath/apollo-core @uipath/apollo-wind\n```\n\n### For Internal UiPath Users (GitHub Package Registry)\n\nIf you have `.npmrc` configured with:\n```\n@uipath:registry=https://npm.pkg.github.com\n```\n\nPackages will automatically install from GitHub Package Registry. No changes needed!\n\n### Testing PR Previews\n\nTo test a feature from an open PR before it's merged:\n\n```bash\n# Install latest PR preview\nnpm install @uipath/apollo-react@dev\n\n# Or install specific PR version (from PR comment)\nnpm install @uipath/apollo-react@5.6.1-pr188.4865fad\n```\n\nPreview versions are published when the `dev-packages` label is added to a PR. Remove the label to stop publishing on new commits. Packages are deprecated on npm and cleaned up from GitHub Package Registry after the PR is closed or merged.\n\n---\n\n## 📦 Packages\n\n### Core Foundation\n\n| Package | Version | Downloads |\n|---------|---------|-----------|\n| **[@uipath/apollo-core](./packages/apollo-core)** | [![npm](https://img.shields.io/npm/v/@uipath/apollo-core)](https://www.npmjs.com/package/@uipath/apollo-core) | [![downloads](https://img.shields.io/npm/dm/@uipath/apollo-core)](https://www.npmjs.com/package/@uipath/apollo-core) |\n\nDesign tokens, 1300+ icons, and fonts. Framework-agnostic foundation for the design system.\n\n---\n\n### Framework Implementations\n\n| Package | Version | Downloads |\n|---------|---------|-----------|\n| **[@uipath/apollo-react](./packages/apollo-react)** | [![npm](https://img.shields.io/npm/v/@uipath/apollo-react)](https://www.npmjs.com/package/@uipath/apollo-react) | [![downloads](https://img.shields.io/npm/dm/@uipath/apollo-react)](https://www.npmjs.com/package/@uipath/apollo-react) |\n| **[@uipath/apollo-wind](./packages/apollo-wind)** | [![npm](https://img.shields.io/npm/v/@uipath/apollo-wind)](https://www.npmjs.com/package/@uipath/apollo-wind) | [![downloads](https://img.shields.io/npm/dm/@uipath/apollo-wind)](https://www.npmjs.com/package/@uipath/apollo-wind) |\n\n- **apollo-react**: Canvas/workflow components, ApChat, icons, Material UI themes (Material UI in maintenance mode)\n- **apollo-wind**: Modern Tailwind CSS + shadcn/ui components (recommended for new development)\n\n---\n\n### Web Components\n\n| Package | Version | Downloads |\n|---------|---------|-----------|\n| **[@uipath/ap-chat](./web-packages/ap-chat)** | [![npm](https://img.shields.io/npm/v/@uipath/ap-chat)](https://www.npmjs.com/package/@uipath/ap-chat) | [![downloads](https://img.shields.io/npm/dm/@uipath/ap-chat)](https://www.npmjs.com/package/@uipath/ap-chat) |\n\nFramework-agnostic AI chat interface web component for vanilla JS, Vue, Angular, etc.\n\n**Note:** React users should import `ApChat` from `@uipath/apollo-react` instead.\n\n---\n\n## 🎨 Live Demos\n\nExplore our components in interactive Storybook environments:\n\n- **[Apollo Vertex](https://apollo-vertex.vercel.app/)** - Complete design system showcase\n- **[Canvas Components](https://apollo-design.vercel.app/)** - Tailwind CSS components \u0026 Workflow and canvas demos\n- **[React Playground](https://apollo-ui-react.vercel.app/)** - Material UI components, design tokens, CSS vars, icons, and chat component\n\n## 📚 Documentation\n\n- **[@uipath/apollo-core](./packages/apollo-core/README.md)** - Design tokens, icons, fonts\n- **[@uipath/apollo-react](./packages/apollo-react/README.md)** - React components and canvas\n- **[@uipath/apollo-wind](./packages/apollo-wind/README.md)** - Tailwind components\n- **[@uipath/ap-chat](./web-packages/ap-chat/README.md)** - Chat web component\n- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute\n\n## 🚀 Contributing\n\n### Prerequisites\n\n- **Node.js** \u003e= 22\n- **pnpm** \u003e= 10\n\n### Setup\n\n```bash\n# Clone and setup\ngit clone https://github.com/UiPath/apollo-ui.git\ncd apollo-ui\npnpm install\n\n# Build packages\npnpm build\n\n# Run Storybook\npnpm storybook:dev\n```\n\n### Development Commands\n\n```bash\npnpm dev              # Watch mode for all packages\npnpm build            # Build all packages\npnpm lint             # Lint all packages\npnpm test             # Run tests\n```\n\n### Component Guidelines\n\nWhen contributing components:\n- ✅ Follow package naming conventions\n- ✅ Use design tokens from `@uipath/apollo-core`\n- ✅ Include TypeScript types\n- ✅ Add Storybook stories\n- ✅ Write unit tests\n- ✅ Update package README\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.\n\n## License\n\nMIT © UiPath\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuipath%2Fapollo-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuipath%2Fapollo-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuipath%2Fapollo-ui/lists"}