CoreAI Sandbox Component Usage
Import Boundary
Import CoreAI components, styling APIs, and tokens directly from
@coreai-ds/react-components.
import { Button, Dropdown, Spinner } from '@coreai-ds/react-components';
Import CoreAI-Sandbox-owned components and adapters from ~/components/common.
import { Card, ExternalLink, Image, Link, TabLinkList } from '~/components/common';
The app barrel exports only repository-owned behavior. It does not re-export CoreAI. Never import
components from @fluentui/react-components directly. Direct imports from
@fluentui/react-icons remain supported.
Use the local Link for React Router navigation, ExternalLink for external URLs, Card for all
cards, and Image for theme-aware and deployment-safe image sources. ESLint restricts direct
Link, Card, and Image imports from @coreai-ds/react-components; only the local adapter
implementations may import those underlying CoreAI components.
Skill Boundary
- This skill owns CoreAI Sandbox's repository boundary: decide whether the need is satisfied by
CoreAI or by an existing app-owned adapter, composition, hook, theme utility, or asset.
coreai-ds-fluentui-react owns external package documentation retrieval and version checks.
Invoke it for every CoreAI component or prop decision instead of restating its catalog
here.
- Local source under
app/components/common/** is authoritative only for CoreAI-Sandbox-owned behavior;
it is not a substitute for CoreAI documentation.
Choose and Verify Components
- Invoke the
coreai-ds-fluentui-react skill and retrieve the relevant published documentation
before selecting, changing, or reviewing a component or its props. Follow its discovery,
version-check, and retrieval-failure workflow. Do not infer APIs from stock Fluent behavior.
- Verify the selected API against the installed package when documented versions differ.
Report missing guidance or unsupported APIs rather than silently substituting prior knowledge.
- Check
app/components/common/index.ts for an existing CoreAI-Sandbox-owned export only when the
requested behavior is product-specific or integrates an app concern such as React Router.
- When a local export exists, read its source under
app/components/common/** before using it.
Published package documentation does not define CoreAI-Sandbox-owned behavior.
- Prefer an existing documented component or template over recreating the same
interaction with custom markup and CSS.
Do not maintain a static component catalog in this skill. Published CoreAI documentation is the
source of truth for CoreAI components, and the app barrel and local source are the
source of truth for repository-owned exports.
Semantics
Use links for navigation and buttons for actions. Do not make a Button navigate
or use a link to perform an action. Use Link for app routes and ExternalLink for URLs outside
the app.
Related skills
css-styling — required when writing styles for the component
icons — for icon selection and bundling
coreai-ds-fluentui-react — required for CoreAI component documentation and API decisions