---
title: "llms.txt"
description: "The docs site auto-generates llms.txt and llms-full.txt to provide large language models with a structured index of the library's capabilities and documentation."
canonical_url: "https://mapbox.mhaibaraai.cn/en/docs/getting-started/ai/llms-txt"
---
# llms.txt

> The docs site auto-generates llms.txt and llms-full.txt to provide large language models with a structured index of the library's capabilities and documentation.

## What is llms.txt?

llms.txt is a structured documentation format designed for large language models (LLMs). The docs site automatically generates llms.txt files via the built-in `nuxt-llms` integration, providing structured information about this component library to help AI tools understand and assist with `@movk/mapbox` development.

These files are optimized for AI consumption, covering components, APIs, usage patterns, and best practices. They are enabled by default and require no manual maintenance.

## Available Routes

The docs site provides the following llms.txt routes:

- [**/llms.txt**](https://mapbox.mhaibaraai.cn/llms.txt): A structured overview of all content with documentation links (~5K tokens)
- [**/llms-full.txt**](https://mapbox.mhaibaraai.cn/llms-full.txt): The complete documentation including implementation details, examples, type definitions, and best practices (large)

## Choosing the Right File

> [!NOTE]
> 
> For most use cases, start with 
> 
> /llms.txt
> 
>  — it contains all core information and fits within a standard LLM context window. Only switch to 
> 
> /llms-full.txt
> 
>  when you need complete implementation examples and your AI tool supports a large context (200K+ tokens).

## Important Usage Note

> [!WARNING]
> 
> When using tools like Cursor or Windsurf, the 
> 
> @
> 
>  symbol must be typed manually in the chat box. Copy-pasting it will break the tool's recognition of context references.

## Using in AI Tools

### Cursor

You can reference the llms.txt files in Cursor for better AI assistance:

1. **Direct reference**: Mention the llms.txt URL in your prompt
2. Use `@docs` to add the URL to your project context

### Windsurf

Windsurf can directly access the llms.txt files to understand component usage and best practices:

- Use `@docs` to reference a specific llms.txt URL
- Create persistent rules in your workspace that reference these URLs

### Other AI Tools

Any AI tool that supports llms.txt can use these routes to better understand the library. Example prompts for ChatGPT, Claude, and others:

- "Use the Movk Mapbox documentation at `https://mapbox.mhaibaraai.cn/llms.txt`"
- "Follow the full guide at `https://mapbox.mhaibaraai.cn/llms-full.txt`"

> [!TIP]
> 
> llms.txt
> 
>  tells AI tools 
> 
> where to find
> 
>  information; 
> 
> Agent Skills
> 
>  tells them 
> 
> what to do and how
> 
> . The two work best together.


## Sitemap

See the full [sitemap](https://mapbox.mhaibaraai.cn/sitemap.md) for all pages.