القائمة
Add new `AppTheme.Icon` entries by pulling Icons8 icons (Arcade style by default) and converting them to Compose ImageVectors via the Valkyrie CLI.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Enforce the Campfire pattern for feature modules to react to Audiobookshelf socket events. Feature impl modules contribute a `SocketEventListener` via `@ContributesMultibinding(UserScope::class, boundType = SocketEventListener::class)` — no `Scoped`, no `CoroutineScopeHolder` injection, no flow collection, no edits to `:infra:socket:impl`. Trigger when authoring or reviewing a class that reacts to socket events, or when asked to "wire X to socket events" / "add a socket listener for Y".
Enforce the Compose guideline that every `@Composable` function must declare `modifier: Modifier = Modifier` as its first optional parameter and apply it to the root layout. Trigger when authoring or reviewing any `@Composable` function — including `private` / `internal` helpers extracted from a UI file.
Extract hardcoded user-facing string literals from a Jetpack Compose / Compose Multiplatform file into the owning module's `composeResources/values/<module>_strings.xml`, then replace each call site with `stringResource(Res.string.<key>, ...)` and add the matching `Res` / key imports. Trigger when the user asks to "localize", "i18n", "extract strings", or "move strings to resources" for a given Compose file.
Enforce the Campfire IconButton accessibility convention — every IconButton (and its derivatives) must be wrapped with `IconButtonTooltip` and given a localized action label. Trigger when reviewing or authoring Compose UI that adds, copies, or moves an icon-only button.
Generate a new set of modules, i.e. a Subproject, in a given directory following a prescribed format
| name | add-theme-icons |
| description | Add new `AppTheme.Icon` entries by pulling Icons8 icons (Arcade style by default) and converting them to Compose ImageVectors via the Valkyrie CLI. |
| argument-hint | ["concept terms or icon ids..."] |
Invoke when the user wants to expand the set of icons available in AppTheme.Icon (used by OOTB AppTheme.Fixed themes and user-built AppTheme.Fixed.Custom themes). Icons should match the app's camping / nature / travel theme.
brew install ComposeGears/repo/valkyrie, check with command -v valkyrie). Required — do not hand-translate SVG paths.mcp__icons8mcp__search_icons, mcp__icons8mcp__get_icon_svg.| Concern | Value |
|---|---|
| Icon style (platform) | arcade (colored; unless user specifies otherwise) |
| Iconpack object | CampfireIcons (defined at common/compose/src/commonMain/kotlin/app/campfire/common/compose/icons/CampfireIcons.kt) |
| Nested pack | Theme |
| ImageVector package | app.campfire.common.compose.icons.theme |
| ImageVector files dir | common/compose/src/commonMain/kotlin/app/campfire/common/compose/icons/theme/ |
| Lazy thread-safety | LazyThreadSafetyMode.PUBLICATION (Valkyrie emits NONE — you must replace it) |
| Indent | 2 spaces (ktlint) |
| Enum location | ui/theming/api/src/commonMain/kotlin/app/campfire/ui/theming/api/AppTheme.kt → AppTheme.Icon |
Search candidates. First read AppTheme.kt and list the existing Icon enum entries so you can exclude them. Then use mcp__icons8mcp__search_icons with platform=arcade and camping/nature/travel query terms (examples: campfire, compass, binoculars, lantern, map, axe, sleeping bag, evergreen, suitcase, log cabin, canoe, fishing, hammock, trail, camper, waterfall, flashlight). Note: some searches return zero (kayak, hammock, thermos) — try synonyms (dinghy, picnic). Fire multiple searches in parallel.
Fetch SVGs in parallel via mcp__icons8mcp__get_icon_svg for each chosen icon id.
Stage SVGs. Write each to /tmp/campfire-icons-svg/<PascalCaseName>.svg. The filename becomes the generated Kotlin property name (CampfireIcons.Theme.<PascalCaseName>) — avoid names that collide with existing Kotlin types (e.g. prefer PaperMap over Map).
Run Valkyrie. Output to a scratch dir first (Valkyrie creates a theme/ subfolder):
valkyrie svgxml2imagevector \
--input-path=/tmp/campfire-icons-svg \
--output-path=/tmp/campfire-icons-out \
--package-name=app.campfire.common.compose.icons \
--iconpack-name=CampfireIcons \
--nested-pack-name=Theme \
--output-format=lazy-property \
--indent-size=2 \
--trailing-comma=true
Key flags: --package-name is the root package (Valkyrie appends .theme from --nested-pack-name); do not pass the full ...icons.theme package or you'll get a doubled path. --trailing-comma=true is required — without it ktlint flags every multi-arg path(...) call.
Post-process — replace Valkyrie's default lazy mode to match project convention:
bash -c 'for f in /tmp/campfire-icons-out/theme/*.kt; do sed -i "" "s/LazyThreadSafetyMode.NONE/LazyThreadSafetyMode.PUBLICATION/g" "$f"; done'
Move into the source tree.
cp /tmp/campfire-icons-out/theme/*.kt \
/Users/r0adkll/StudioProjects/Campfire/common/compose/src/commonMain/kotlin/app/campfire/common/compose/icons/theme/
Wire into AppTheme.Icon. In ui/theming/api/src/commonMain/kotlin/app/campfire/ui/theming/api/AppTheme.kt:
import app.campfire.common.compose.icons.theme.<Name> (keep alphabetical ordering).<Name>(icon = { CampfireIcons.Theme.<Name> }), to the Icon enum.Verify. Run --format first (it auto-fixes the alphabetical import reordering that adding new imports can break), then compile:
./scripts/ktlint --format
./gradlew :common:compose:compileKotlinIosSimulatorArm64 :ui:theming:api:compileKotlinIosSimulatorArm64 --console=plain
Pre-existing warnings (ExperimentalMaterial3Api opt-in, dayOfMonth deprecation, SynchronizedObject under compileCommonMainKotlinMetadata) are unrelated — ignore.
Clean up /tmp/campfire-icons-svg and /tmp/campfire-icons-out.
AppThemeImage via Image(...) (not Icon(... tint)), so the original Arcade colors come through — do not convert to single-color vectors.AppTheme.Fixed.Custom.icon), so every added entry is immediately user-selectable.color, plumpy), pass that as the platform filter in step 1 — the rest of the workflow is identical.