Gradle plugins

io.cstories.gradle

The main catalog plugin. Applies to the module that hosts your stories.

• adds the required CStories dependencies (cstories-annotations, cstories-runtime, the cstories-processor KSP dependency)
• generates a catalog entry point for whichever target(s) (jvm(), wasmJs) the module already declares
• registers the runCStoriesDesktop, runCStoriesDesktopHotReload, runCStoriesWasm, and cstoriesExportWeb tasks

Applying it with neither jvm() nor wasmJs declared fails fast with a clear error.

io.cstories.gradle.components

A lightweight plugin for plain component/design-system library modules. Applies to the module that declares your components, when it's different from the module that declares the stories demonstrating them.

• does not apply Compose Multiplatform
• does not require a jvm()/wasmJs() target
• does not wire any catalog/entry-point task
• wires KSP to process @CStoryComponent and generate io.cstories.generated.CStoryComponentRefs

See Reference a component in a story for when this plugin is needed.

Choosing between the two

Situation	Plugin to apply
Components and stories live in the same module	io.cstories.gradle only
Components and stories live in different modules	io.cstories.gradle on the stories module, io.cstories.gradle.components on the components module