summon

The Summon skill provides specialized assistance for the Summon Kotlin Multiplatform UI framework, enabling developers to build declarative, type-safe web and JVM applications. It is designed for Kotlin developers who require a Compose-like experience while targeting Browser (JS/WASM) and Server-Side Rendering (SSR) environments. Whether you are scaffolding a project with the Summon CLI, managing reactive state, or implementing complex routing logic, this skill acts as an authoritative source for the framework's conventions, API surface, and build best practices.

• Component-based architecture with Compose-like declarative syntax and lifecycle hooks including onMount and onDispose.

• Type-safe modifier system that replaces raw CSS with Kotlin DSL, ensuring robust styling via units like px, rem, and em.

• Integrated routing engine supporting static, dynamic, and catch-all routes with automatic parameter handling.

• Full SSR and hydration support for improved SEO and initial load performance in web applications.

• Advanced state management utilities including remember, mutableStateOf, and property delegation patterns.

• Cross-platform support covering commonMain, webMain (JS/WASM), and jvmMain source set hierarchies.

• Built-in accessibility (ARIA) features and i18n support to help developers build inclusive, globalized applications.

• Utilize the Summon CLI for project generation and scaffold choices between standalone JS or full-stack integrations like Spring Boot, Ktor, and Quarkus.

• Always apply @JsName annotations to public APIs to prevent minification-related naming conflicts in JavaScript.

• Strictly adhere to the migration to the codes.yousef package namespace for versions 0.6.0 and above.

• Avoid direct DOM manipulation; always rely on the PlatformRenderer and its exposed methods to ensure cross-platform compatibility.

• Use the provided modifier API for all styling to maintain type safety and benefit from the extensive Material Design and Catppuccin color palettes.

• When debugging WASM builds, prioritize cleaning the build cache using ./gradlew clean to resolve potential staleness issues.

• The skill expects standard Kotlin/JVM toolchains and Gradle configurations for build automation, testing, and deployment.