About CoreAI
How is CoreAI different from Fluent?
CoreAI builds on Fluent UI v9. It adds a shared visual language, themes, and component defaults, such as circular buttons and filled cards. Components without CoreAI changes pass through from Fluent.
Use the Variations from Fluent guide to check differences before copying a Fluent example.
Why does CoreAI have a shared design system?
CoreAI gives teams one Fluent UI v9 design system for shared components, themes, guidance, and tools. This helps apps stay consistent without each team maintaining its own version of the same patterns.
What is the difference between components, templates, and samples?
Components are reusable controls maintained in the npm package.
Templates are larger starting points that you copy into your project and maintain yourself. They are not package imports.
Samples show how components work together in a form, layout, or workflow.
Getting started
How do I install the npm package?
Install @coreai-ds/react-components from npm, then follow the package README for provider, font, and usage guidance.
Why does my app still look like stock Fluent?
Import components from @coreai-ds/react-components instead of @fluentui/react-components, then wrap the app in CoreAIFluentProvider. Icons can still come from @fluentui/react-icons.
Check that withComponentDefaults has not been set to false. The optional fonts.css import only registers Aptos fonts already installed on the device. The theming guide covers the provider, fonts, and defaults.
Using components
Does a Figma preview mean the component is available in code?
No. Some pages show a Figma preview because a code component is not available. Check the component documentation and page resources before assuming it is part of the package.
Can I change the theme or customize a component?
Yes. CoreAI supports light and dark themes, Azure themes, and custom brand colors through its theme factories.
For individual components, start with documented props and design tokens. Preserve the existing behavior and accessibility. The theming guide covers theme setup.
Working with agents
What does my coding agent need to use CoreAI?
Install the package to build an application. Agents can read the same UX guidance and complete examples as people through this site's Markdown endpoints with ordinary HTTPS.
See Working with agents for a starter prompt that installs or updates the repository skill before UI work. The skill checks the current docs/skill version once per task. Its version can change independently of the component package.
How can I give my agent the guidance on a component page?
Use View .md on a page, or replace its trailing slash with .md. Preserve the deployment base path. Share that URL with the agent; it contains the same guidance and example source as the human page.
What if the agent cannot fetch documentation?
Check the page URL, network connection, and whether your agent has a web-fetch or HTTP tool. Start at llms.txt.
If the server is unavailable, have your agent use the installed package README, changelog, and skill, and state that it cannot access live docs. Report persistent connection problems through GitHub issues.
Help and feedback
How do I give feedback or contribute?
Use GitHub Issues to report a bug, request a component or pattern, or ask a usage question. Search existing issues first, then include what you need and a small example.
Contributions can include guidance and design ideas as well as code. Do not report security vulnerabilities through a public issue; follow the private instructions in SECURITY.md.