Docs for agents
Plain-text versions of these docs for AI coding agents, following the llms.txt convention.
Coding agents such as Claude Code, Cursor and Copilot work better from plain Markdown than from rendered pages. The site serves the same docs as text, so an agent can read the components, props and tokens before it writes code.
| URL | Contents |
|---|---|
/llms.txt | Rules for using the library and a list of every page, with a description and a link. |
/llms-full.txt | Every page in one file, for agents that load all the docs at once. |
/docs/<page>.md | One page as Markdown, such as /docs/components/button.md. |
Each page's Markdown has the import line, every example as complete TSX with its imports and state, and the props as tables. The foundations pages list their tokens as tables. Each HTML page also links its Markdown version with <link rel="alternate" type="text/markdown">.
Point your agent at the docs
Add a note to the instructions file your agent reads, such as AGENTS.md, CLAUDE.md or .cursor/rules. Replace https://docs.example.com with the address of this site.
## UI components
This app uses `@aksornproject/aksara-ui`. Before writing UI code, read
https://docs.example.com/llms.txt and the Markdown page of each component
you use. Use only the props in its API table and style with token utilities.Choose a file
- Start from
/llms.txt. It is small, and the agent fetches only the pages it needs. - Use
/llms-full.txtwhen the agent can't fetch URLs, or to paste the whole library into a long-context chat. It is large, so prefer single pages for everyday tasks. - To give an agent one component, add
.mdto the page URL and paste the result.
What agents should follow
/llms.txt starts with the rules that matter most when an agent writes code:
- Import everything from the package root.
- Load the theme after Tailwind.
- Style with token utilities such as
p-spacing-16andbg-color-accent, not bare Tailwind numbers or hex values. - Use only the props in a component's API table.
The same rules are in Usage and Installation.