Getting Started

Source Setup

pnpm install --frozen-lockfile
pnpm package:prepare

Installation

Start from a Svelte 5 application, then install the package, shared theme, and Bits UI peer.

npm install coss-svelte @coss-svelte/theme bits-ui

Theme

Import the COSS theme once from the global stylesheet loaded by your app layout so local components receive the same token system as the docs previews.

@import "tailwindcss";
@import "@coss-svelte/theme/style-coss.css";

Registry Preview

The copy-and-own registry is a preview in 0.1.0. Download a manifest such as Button:

curl -fsSL https://coss-svelte.vercel.app/r/button.json -o button.json

Each manifest lists dependencies and files. Write each file's content to src/lib/<target>, install the listed dependencies, import the shared theme, and maintain the copied source in your application. Registry source and schemas may evolve between minor releases.

Getting your agents to use coss-svelte

Use the coss-svelte skill when an agent needs implementation rules for Svelte, Bits UI, Tailwind CSS 4, and the current component status boundaries.

coss-svelte exposes a local docs map at /llms.txt, raw Markdown routes for component pages, and Copy Markdown actions for page-level context.