fragments/ui-setup

Install the Fragments UI library and configure FragmentsProvider in React projects.

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/fragments-sdk/skills --skill fragments-ui-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fragments/ui-setup
Source: https://github.com/fragments-sdk/skills/tree/main/skills/ui-setup
Command: npx skills add https://github.com/fragments-sdk/skills --skill fragments-ui-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of installing and wiring up the Fragments UI design system so components render correctly with theming, tokens, and an optional AI MCP server.

Core Features & Use Cases

  • Environment-aware setup: Detects package manager, framework (React/Next/Vite/Remix), and TypeScript/module resolution needs to avoid broken imports.
  • Correct installation and styling: Installs @fragments-sdk/ui and icon dependencies, and configures the required CSS import order so tokens load properly.
  • Provider wiring + first component: Sets up FragmentsProvider in the right place (including Next.js client component constraints) and creates a sample component to confirm it works.
  • Optional MCP server configuration: Adds the Fragments MCP server into an existing Claude settings file without overwriting other MCP servers.

Quick Start

Run the fragments/ui-setup skill to install @fragments-sdk/ui, add the required CSS import, wrap your app with FragmentsProvider using your chosen theme, and render the included Welcome component.

Frequently Asked Questions about fragments/ui-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a React design system provider with theming in Next.js?

To set up a React design system provider with theming in Next.js, you wrap your app with FragmentsProvider and import the required stylesheet. This ensures components render correctly with tokens, applying to App Router, Pages Router, Vite, and Remix.

What is the correct CSS import order for Fragments UI tokens?

The correct CSS import order for Fragments UI tokens requires the stylesheet to load before component styles. This Skill configures the necessary imports automatically so tokens load properly and theming applies without visual conflicts.

Does Fragments UI work with Vite and Remix frameworks?

Yes, Fragments UI works with Vite and Remix frameworks. The setup detects your React-based framework and applies the correct provider wiring, including Next.js client component constraints and TypeScript module resolution checks.

How do I add an MCP server to Claude settings without overwriting existing servers?

To add an MCP server to Claude settings without overwriting existing servers, the setup performs a safe optional merge into the .claude/settings.json file. This preserves your current MCP server configurations while integrating the Fragments server.

Why are my Fragments UI component imports broken in a TypeScript monorepo?

Broken Fragments UI component imports in a TypeScript monorepo often stem from subpath export resolution failures. This setup checks for TypeScript 5+ and sets moduleResolution to bundler when needed to resolve monorepo and module edge cases.

Can I install a React UI component library and verify it with a sample component?

Yes, you can install a React UI component library and verify it with a sample component. This setup installs the packages, configures the provider, and renders an included Welcome component as a sanity check to confirm the integration works.