# StyleRef Documentation

> Developer and product documentation for StyleRef — define a creative style once (colors, typography, mood, voice, composition, lighting) and reuse it across ChatGPT, Claude, Gemini, Midjourney, FLUX, ComfyUI and any other AI tool.

> Every page has a raw-markdown twin: append `.md` to any path (e.g. https://docs.styleref.io/introduction/quickstart.md). Prefer it over the HTML — same content, no navigation chrome, roughly a third of the tokens.
> Whole documentation set: ~35.5K tokens across 35 pages. Product-level facts (pricing, plans, key facts) live at https://styleref.io/llms.txt.

## Home

- [StyleRef Documentation](https://docs.styleref.io): Documentation for StyleRef — define a creative style once and reuse it across any AI tool. (~320 tokens)

## Introduction

- [What is StyleRef](https://docs.styleref.io/introduction/what-is-styleref): StyleRef is a structured, portable creative style specification you define once and reuse across any AI tool. (~883 tokens)
- [Quickstart](https://docs.styleref.io/introduction/quickstart): Apply a StyleRef gallery style in an AI tool in about five minutes — no signup required. (~751 tokens)
- [Core concepts](https://docs.styleref.io/introduction/core-concepts): The vocabulary StyleRef uses — style spec, formats, style references, visibility, extraction, and STYLE.md. (~1.2K tokens)

## Using StyleRef

- [Create a style](https://docs.styleref.io/using-styleref/create-a-style): Build a style on the Style Board — pick blocks per section, set values in the Inspector, and generate your StyleRef. (~1.0K tokens)
- [Extract a style](https://docs.styleref.io/using-styleref/extract-a-style): Use AI to build a style from text, images, or documents — review the extracted blocks and apply them to your board. (~915 tokens)
- [Gallery, sharing & remixing](https://docs.styleref.io/using-styleref/gallery-sharing-remixing): Share a style by link, publish it to the gallery, remix others' styles, and manage visibility — with moderation at each step. (~817 tokens)
- [Plans & limits](https://docs.styleref.io/using-styleref/plans-and-limits): How StyleRef's Free and Pro plans work — the credit system, per-action costs, and what Pro unlocks. (~918 tokens)
- [Use your style in AI tools](https://docs.styleref.io/using-styleref/use-in-ai-tools): Which format to use and where to place it, per AI tool — with the rules that make a style hold. (~443 tokens)
- [ChatGPT, Claude & Gemini](https://docs.styleref.io/using-styleref/use-in-ai-tools/chatgpt-claude-gemini): Apply a StyleRef style in chat assistants and their image modes using the default format. (~511 tokens)
- [Midjourney](https://docs.styleref.io/using-styleref/use-in-ai-tools/midjourney): Apply a StyleRef style in Midjourney using the midjourney format — subject first, style keywords and parameters last. (~407 tokens)
- [FLUX & diffusion models](https://docs.styleref.io/using-styleref/use-in-ai-tools/flux-diffusion): Apply a StyleRef style in FLUX, DALL·E, and Stable Diffusion using the flux and diffusion formats. (~428 tokens)

## STYLE.md

- [What is STYLE.md](https://docs.styleref.io/style-md/what-is-style-md): STYLE.md is a per-project creative style contract that agents and humans both read. (~518 tokens)
- [Format reference](https://docs.styleref.io/style-md/format-reference): The STYLE.md file structure — frontmatter, sections, body, and the rules the linter enforces. (~942 tokens)
- [Add STYLE.md to a project](https://docs.styleref.io/style-md/add-to-a-project): Write a STYLE.md into a repo and reference it from AGENTS.md so agents apply the style. (~550 tokens)
- [Validate & lint](https://docs.styleref.io/style-md/validate-and-lint): Check a STYLE.md is well-formed with the CLI, the REST endpoint, or the MCP tool. (~698 tokens)
- [The "Styled with STYLE.md" badge](https://docs.styleref.io/style-md/badge): Add the "Styled with STYLE.md" README badge to a repo that follows a STYLE.md. (~300 tokens)

## For AI & agents

- [Overview — choosing a surface](https://docs.styleref.io/for-ai-agents/overview): Which StyleRef integration to use — MCP, REST, CLI, Agent Skill, llms.txt, or STYLE.md. (~519 tokens)
- [CLI (npx styleref)](https://docs.styleref.io/for-ai-agents/cli): The styleref CLI — pull, init, validate, search, login, and logout from the terminal. (~838 tokens)
- [Agent Skill (SKILL.md)](https://docs.styleref.io/for-ai-agents/agent-skill): The distributable StyleRef Agent Skill — what it teaches an agent, how to install it, and when to prefer it. (~721 tokens)
- [llms.txt & markdown endpoints](https://docs.styleref.io/for-ai-agents/llms-txt): StyleRef's machine-readable surfaces — llms.txt, llms-full.txt, and raw-markdown endpoints. (~884 tokens)
- [Connect your client](https://docs.styleref.io/for-ai-agents/mcp/connect-your-client): Connect an MCP client to the StyleRef server over Streamable HTTP and verify with a first call. (~571 tokens)
- [Tools reference](https://docs.styleref.io/for-ai-agents/mcp/tools-reference): Every StyleRef MCP tool — parameters, scopes, and examples. Anonymous read tools and account-scoped actions. (~2.2K tokens)
- [Resources & prompts](https://docs.styleref.io/for-ai-agents/mcp/resources-and-prompts): StyleRef MCP resources (addressable data) and prompts (reusable interaction templates). (~968 tokens)
- [Authentication & scopes](https://docs.styleref.io/for-ai-agents/mcp/authentication-and-scopes): StyleRef MCP OAuth 2.1 — scopes, the authorization flow, and how connecting looks per client. (~672 tokens)
- [Overview & authentication](https://docs.styleref.io/for-ai-agents/rest-api/overview-and-authentication): The StyleRef REST API v1 — base URL, anonymous reads, the authenticated extraction tier, bearer auth, scopes, credits, and rate limits. (~1.7K tokens)
- [Endpoints reference](https://docs.styleref.io/for-ai-agents/rest-api/endpoints-reference): Every StyleRef REST API v1 endpoint — search, get a style, get a STYLE.md, validate, extract from an image, and read your library and extraction history — with curl and JS examples. (~4.1K tokens)
- [OpenAPI specification](https://docs.styleref.io/for-ai-agents/rest-api/openapi-specification): The canonical OpenAPI 3.1 contract for the StyleRef REST API v1. (~594 tokens)

## Connectors

- [Connectors](https://docs.styleref.io/connectors/overview): Open-source plugins that make StyleRef styles usable natively inside creative tools. (~573 tokens)
- [Building a connector](https://docs.styleref.io/connectors/building-a-connector): How to integrate StyleRef into a creative tool — the API surface, the contracts to depend on, and what to leave server-side. (~1.3K tokens)
- [Install & quickstart](https://docs.styleref.io/connectors/comfyui/install-and-quickstart): Install the StyleRef nodes for ComfyUI and generate your first styled image. (~988 tokens)
- [Nodes reference](https://docs.styleref.io/connectors/comfyui/nodes-reference): Every input, output, and option on the five StyleRef nodes for ComfyUI. (~2.6K tokens)
- [Login & credits](https://docs.styleref.io/connectors/comfyui/login-and-credits): Sign in to the StyleRef ComfyUI nodes, including on remote and headless machines. Nothing in the plugin spends credits. (~1.2K tokens)
- [Workflow templates](https://docs.styleref.io/connectors/comfyui/workflow-templates): Four ready-made ComfyUI workflows using StyleRef styles, from a 60-second demo to a full breakdown of a style's sections. (~1.6K tokens)

## Updates

- [Changelog](https://docs.styleref.io/updates/changelog): What's new in StyleRef — new capabilities for people using the product, newest first. (~2.0K tokens)

## Agent surfaces

- MCP server: `https://styleref.io/api/mcp` (Streamable HTTP, stateless). Anonymous read tools need no login. Install in Claude Code: `claude mcp add --transport http styleref https://styleref.io/api/mcp`.
- REST API v1: `https://styleref.io/api/v1` — OpenAPI 3.1 at https://styleref.io/api/v1/openapi.json. Anonymous and read-only for public styles.
- CLI: `npx styleref` — see the CLI page above.
- Style cards: `https://styleref.io/share/{slug}.md` returns a compact markdown card for any public style, including the MCP resource URI and REST endpoint for its full specification.

## Contact

- Website: https://styleref.io
- Documentation: https://docs.styleref.io
- Support: support@styleref.io