microsoft/coreai-design-system

microsoft/coreai-design-system

Description: The Microsoft CoreAI Design System used in Microsoft Foundry and built on top of Microsoft Fluent Design System.

Language: TypeScript

License: CC-BY-4.0

Stars: 2

Forks: 0

Open issues: 5

Created: 2026-09-24T18:15:05Z

Pushed: 2026-10-17T02:38:10Z

Default branch: main

Fork: no

Archived: no

README:

CoreAI

> Our agentic collaborators live on a curved surface of possibilities. This design system gives that surface its shape for both humans and agents to navigate.

This is the monorepo for CoreAI, a Fluent UI v9 design system.

Code, issues, pull requests, and GitHub Actions are available at microsoft/coreai-design-system.

Documentation is available under the [Creative Commons Attribution 4.0 International license](LICENSE), and source code is available under the [MIT license](LICENSE-CODE). Use the links below to explore the documentation, Storybook, and read-only MCP endpoint.

Live links

| Resource | URL | | -------------------- | ------------------------------------------------------------------------------------------ | | 🏠 Docsite (landing) | https://coreai-ds.azurewebsites.net | | 📚 Storybook | https://coreai-ds-storybook.azurewebsites.net | | 🤖 MCP endpoint | https://coreai-ds-storybook.azurewebsites.net/mcp | | 📦 Package (npm) | `@coreai-ds/react-components` |

Workspaces

| Path | Package | Purpose | | ------------------------------------------------------ | --------------------------------------------- | ----------------------------------------------------------------------------------------------- | | [apps/docsite](apps/docsite) | @coreai-ds/docsite (not published to npm) | Infrastructure scaffold for static docsite build/serve and Azure App Service deployment wiring. | | [packages/react-components](packages/react-components) | @coreai-ds/react-components | The publishable theme package. Drop-in ` + CoreAI-wrapped components. | | [apps/storybook](apps/storybook) | @coreai-ds/storybook (not published to npm) | Storybook playground that previews the theme against Fluent UI's canonical stories. | | [apps/prototype](apps/prototype) | @coreai-ds/prototype` (private) | CoreAI prototype app. See its README for the current migration scope and local setup. |

• Consumer + extension guide: [packages/react-components/README.md](packages/react-components/README.md)
• Storybook, fluent-stories/, and the MCP for AI agents (authoring): [apps/storybook/README.md](apps/storybook/README.md)
• GitHub Actions workflows and operations: [docs/GITHUB-ACTIONS.md](docs/GITHUB-ACTIONS.md)
• Azure app + MCP hosting/auth: [docs/CI-CD-SETUP.md](docs/CI-CD-SETUP.md)

Contributing and support

See [CONTRIBUTING.md](CONTRIBUTING.md) to set up the repository and submit changes. By participating in this project, you agree to follow the Microsoft Open Source Code of Conduct.

Use GitHub Issues for bugs, feature requests, and usage questions. See [SUPPORT.md](SUPPORT.md) for the support policy and [SECURITY.md](SECURITY.md) for private vulnerability reporting.

Documentation organization

To keep a single source of truth and avoid drift/duplication, every doc in this repo belongs to exactly one of these categories. Before adding new documentation, place it per this table and cross-link to the owning doc instead of restating its content:

| Category | Covers | Home | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Operational docs | Build, release process, CI/CD auth, contribution process/governance, deploy | Each package/app's own README.md, plus additional scoped docs alongside it when a topic needs more depth (e.g. RELEASING.md, CONTRIBUTING.md) — always specific to the package/app they describe, never a generic repo-wide doc for one workspace's process. Concerns that genuinely span multiple workspaces (e.g. shared CI/CD auth, app hosting) live in the repo-root [docs/](docs) folder instead. | | Usage docs | Component/theme usage, API behavior, MCP consumption, template-authoring conventions | Storybook docs ([apps/storybook/src/stories/docs/*.mdx](apps/storybook/src/stories/docs) "Docs" pages + JSDoc-driven autodocs) — single source, live at the hosted Storybook, and addressable by the MCP tools | | Changelog | Version history | Each publishable package's own CHANGELOG.md | | Workflow skills | Procedural steps for an agent to execute a task in this monorepo (PR/commit conventions, release steps) | [.github/skills/*/SKILL.md](.github/skills) — numbered steps, checklists only; no conceptual/reference content — link out to whichever doc above owns it | | Agent skill | Distributable, concise operating rules for an agent _consuming_ @coreai-ds/react-components (MCP server precedence, component-ID quirks, template-vs-component, offline fallback) | [packages/react-components/agent/SKILL.md](packages/react-components/agent/SKILL.md) — ships inside the published npm package (works for consumers outside this monorepo, with no MCP access needed) and is mirrored into a generated Storybook doc page so it's also addressable by the MCP tools; see [apps/storybook/README.md](apps/storybook/README.md#agent-skill-mirror) |

This is distinct from the Workflow skills row above: those describe how an agent should _contribute to this repo_; the Agent skill describes how an agent should _use the package_, and travels with it wherever it's installed.

Quickstart

npm install # bootstrap all workspaces (one root install)
npm run docsite # http://localhost:8080
npm run storybook # http://localhost:6006

Aptos is the preferred typeface but is not redistributed in this repository or the npm...