// Sets up and launches the Apollo Wind Storybook from scratch. Use when the user wants to run Apollo Wind, start Storybook, set up the apollo-ui repo, or says something like "get apollo running", "set up apollo", or "start apollo storybook".
| name | apollo-install |
| description | Sets up and launches the Apollo Wind Storybook from scratch. Use when the user wants to run Apollo Wind, start Storybook, set up the apollo-ui repo, or says something like "get apollo running", "set up apollo", or "start apollo storybook". |
Fully sets up and launches the Apollo Wind Storybook in a single flow. Run each step in order — verify success before proceeding to the next.
node --version
pnpm --version
Node below 18 or missing: Tell the user to install Node 18+ from https://nodejs.org and stop.
pnpm missing: Install it, then continue.
npm install -g pnpm
Check if the repo already exists before cloning.
ls ~/Desktop/apollo-ui
If it does not exist, clone it. Try SSH first:
cd ~/Desktop
git clone git@github.com:UiPath/apollo-ui.git
If SSH fails (no key configured), fall back to HTTPS and let the user know:
cd ~/Desktop
git clone https://github.com/UiPath/apollo-ui.git
cd ~/Desktop/apollo-ui
pnpm install
Wait for full completion before continuing.
pnpm build
Turborepo builds apollo-core, apollo-react, and apollo-wind in dependency order. Wait for completion.
pnpm storybook:design
Storybook opens automatically at http://localhost:6006. If it does not open, tell the user to navigate there manually.
Apollo Wind Storybook is running at http://localhost:6006. Browse components, templates, and tokens in the sidebar. To start prototyping, go to Introduction → Prototyping.
git@github.com: Permission denied
SSH key not configured. Retry with HTTPS (see Step 2).
ERR_PNPM_UNSUPPORTED_ENGINE
Node version is too old. Ask the user to upgrade to Node 18+.
Cannot find module during build
Dependencies are incomplete. Re-run pnpm install then pnpm build.
Port 6006 already in use Another Storybook instance is running. Tell the user to stop it or open http://localhost:6006 directly.
Use when fixing npm/pnpm security vulnerabilities, Dependabot alerts, or audit failures
Use when creating or reviewing GitHub Actions workflows in this repo. Applies all security patterns established during the apollo-ui hardening session — permissions, action pinning, checkout safety, install patterns, secrets handling, fork protection, Turbo caching, artifacts, and minimumReleaseAge.
Applies UiPath UX writing guidelines to UI copy — labels, buttons, errors, modals, empty states, and all microcopy. Use when writing or reviewing UI text, copy, or content for UiPath products.
Migrate an apollo-react canvas component from Emotion styled-components to apollo-wind Tailwind classes following the BaseNode reference migration patterns
Use when cutting a maintenance/support branch for an older major version of an apollo-ui package (e.g. apollo-react v3, v4, v5). Orchestrates branch creation, pushes it bare, then opens a PR with workspace dep locking, release config, and lockfile regeneration. Confirms commit messages and git actions with the user before executing them.
Keeps apollo-wind up to date in a designer's prototype repo and ensures it is correctly configured. Use when the user wants to sync apollo-wind, update components, set up apollo-wind in their project, or at the start of any prototyping session to ensure they are on the latest version.