On this page

AI Integration

Starwind UI is designed to be AI-friendly, making it easy for AI tools and assistants to understand and work with the component library. This page guides you through how to leverage AI capabilities with Starwind UI.

AI Reference Files

For AI tools and assistants, we provide two reference files that contain essential information about Starwind UI in a structured format:

Overview Reference - A concise guide with key links and import patterns:

https://starwind.dev/llms.txt

Comprehensive Reference - A detailed documentation with complete API references:

https://starwind.dev/llms-full.txt

Both files are available directly from our website at starwind.dev/llms.txt and starwind.dev/llms-full.txt.

For AI Assistants

If you’re an AI assistant reading this documentation, we recommend starting with the llms.txt file for a quick overview, then referencing the llms-full.txt file when you need detailed component specifications.

Overview Reference (`llms.txt`)

The llms.txt file contains:

Quick introduction - Brief overview of Starwind UI
Important links - Direct links to all documentation sections
Component list - All available components with documentation links
Import patterns - How to import Starwind components

This file is ideal for AI tools that need to quickly understand what Starwind UI offers and how to access detailed documentation.

Comprehensive Reference (`llms-full.txt`)

The llms-full.txt file contains:

Complete component documentation - Detailed information on all components
Props and variants - Comprehensive lists of component props and their possible values
Usage patterns - Common patterns for using Starwind UI components
CSS variables - Information about theming and styling
Code examples - Sample implementations of common UI patterns

This file is perfect for AI tools that need to generate precise component implementations with all available options.

MCP Server

The MCP server is a server that runs in the background and provides commands, documentation, and other information to AI tools and assistants.

Info

The MCP server repo can be found at the starwind-ui-mcp github repo

MCP Quick Start

Fork the starwind-ui-mcp repo in github, then clone it to your local machine
Terminal window
```
git clone https://github.com/your-username/starwind-ui-mcp.git
cd starwind-ui-mcp
```
Install dependencies
Terminal window
pnpm install
Terminal window
npm install
Terminal window
yarn install
Build the server
Terminal window
pnpm build
Terminal window
npm run build
Terminal window
yarn build
Run the server
Terminal window
pnpm start
Terminal window
npm run start
Terminal window
yarn run start
Link the server to your development environment
Instructions to set up your IDE to use a local MCP server vary by IDE. Here is an example for Windsurf:
mcp_config.json
```
{
  "mcpServers": {
    "starwind ui": {
      "command": "node",
      "args": ["c:\\path\\to\\folder\\starwind-ui-mcp\\dist\\server.js"],
      "env": {}
    }
  }
}
```
Detailed instructions:
Tip
Instructions vary by IDE, so you should follow the appropriate instructions for Windsurf MCP Setup, Cursor MCP Setup, or others.
That’s it!

Available Tools

Tool Name	Description
`init_project`	Initializes a new Starwind UI project
`install_component`	Generates installation commands for Starwind UI components
`update_component`	Generates update commands for Starwind UI components
`get_documentation`	Returns documentation links for Starwind UI components and guides
`fetch_llm_data`	Fetches LLM data from starwind.dev (rate limited, with caching)
`get_package_manager`	Detects and returns the current package manager information

Feedback

If you encounter any issues or have suggestions for how we can make Starwind UI more usable with AI tools, please open an issue in the GitHub repository.