# UNIS Design System

> Official UNIS brand guidelines, component references, and API documentation for people and AI agents.

## Canonical Resources
- [Design guidelines](https://design.unisco.com/design.md): How to design and build surfaces that read as officially authored here.
- [Homepage](https://design.unisco.com/): Public entry point for the design system.
- [API Docs](https://design.unisco.com/docs/api): Human-readable API documentation.
- [OpenAPI](https://design.unisco.com/openapi.json): Machine-readable API description.
- [API Catalog](https://design.unisco.com/.well-known/api-catalog): RFC 9727 API discovery document.
- [Agent Skills](https://design.unisco.com/.well-known/agent-skills/index.json): Agent skills discovery index.
- [MCP Server Card](https://design.unisco.com/.well-known/mcp/server-card.json): Browser and MCP discovery metadata.

## Public llms.txt Files
- [Home](https://design.unisco.com/llms/home.txt): Start here for the public overview of the UNIS design system.
- [Business Card Request](https://design.unisco.com/llms/business-card-request.txt): Rules and examples for requesting UNIS business cards: field limits, phone and address formats, quantities, and delivery.
- [Guidelines Introduction](https://design.unisco.com/llms/introduction.txt): Introduces the structure and purpose of the brand guidelines.
- [Logo Guidelines](https://design.unisco.com/llms/logos.txt): Covers approved logo variants, spacing, downloads, and misuse examples.
- [Brand Colors](https://design.unisco.com/llms/brand-colors.txt): Lists the primary, secondary, and grayscale colors used by the brand.
- [Typography](https://design.unisco.com/llms/typography.txt): Documents the UNIS typography system and approved typefaces.
- [Photography](https://design.unisco.com/llms/photography.txt): Explains the photography style, tone, and composition guidance.
- [Component Blocks](https://design.unisco.com/llms/component-blocks.txt): Provides the public component block library overview and registry links.
- [Shadcn Colors](https://design.unisco.com/llms/shadcn-colors.txt): Documents the shadcn-based UI color token system used by the project.
- [Document Templates](https://design.unisco.com/llms/document-templates.txt): Explains the document template library and its supported formats.
- [API Documentation](https://design.unisco.com/llms/api.txt): Human-readable API documentation for request flows, auth, and assistant endpoints.

## Notes
- Protected internal guideline sections are not listed here.
- When available, request HTML pages with `Accept: text/markdown` for a page-specific markdown response.