walkietalkie-themes

name

walkietalkie-themes

description

Specialized skill for the Talky/WalkieTalkie theme system (19 themes, GPU shaders, custom fonts, sound packs, Pro gating). Use this when the user asks to add/create/new/modify/design a theme, fix theme colors, change palette, add animated particle backgrounds, register fonts, wire ThemeSoundManager, fix ThemeRegistry (which is MISSING in the codebase), add localization keys for themes, adjust Pro-locking logic, modify ThemeSelectorView or ThemePurchaseSheet, or debug theme-related build failures. Also trigger on phrases like "lava theme", "new animated theme", "the palette doesn't look right", "ThemeRegistry not found", "theme.name.hacker missing". This skill understands all 19 Theme enum cases, the 3 pack files (ColorPack, IdentityPack, AnimatedPack), the ThemeMetadata struct, the Canvas-based GPU particle engine in AnimatedBackgroundView, and the bridge-key Pro gating system. It can generate complete theme code from a natural-language description, dispatch parallel agents for independent tasks, and call frontend-design-open for design review. Use this INSTEAD of the generic walkietalkie-ios skill when the task is theme-specific, even partially.

Talky Theme System — Skill Specializzata

Progetta, crea, modifica e debugga il sistema temi di Talky (19 temi, GPU shader, font custom, sound pack, Pro gating).

Integrazione con Superpowers

Questa skill sfrutta le superpowers:

• dispatching-parallel-agents — per creare pack file + localizzazioni + shader in parallelo
• subagent-driven-development — per piani strutturati multi-file
• frontend-design-open — per revisione estetica delle palette generate

Non caricare tutte le reference insieme. Leggi solo quella che serve al task corrente.

---

Reference Files

File	Quando leggerlo
references/theme-architecture.md	Capire come funziona il sistema, risolvere bug, fare refactoring
references/theme-creation-workflow.md	Aggiungere un nuovo tema (step-by-step)
references/gpu-shader-templates.md	Creare/modificare temi animati (Canvas particle engine)
references/design-guidelines.md	Generare palette, scegliere icone, font, sound pack

---

Workflow: Creare un Nuovo Tema

1. Leggi references/design-guidelines.md per progettare la palette
2. Leggi references/theme-creation-workflow.md per la checklist completa
3. Se animato → leggi anche references/gpu-shader-templates.md
4. Usa agenti paralleli per task indipendenti:
   • Un agente scrive il pack file + enum case
   • Un agente aggiunge le localizzazioni in 5 lingue
   • Un agente scrive lo shader (se animato)
5. Verifica con xcodebuild (comando in fondo)

PRIMA di tutto: Controlla ThemeRegistry

Il progetto ha ThemeRegistry mancante. È referenziato in 3 file (Theme.swift:49, ThemePurchaseSheet.swift:45, ThemeSoundManager.swift:33,41) ma non esiste. Se non è già stato creato, la build fallisce. Prima di fare qualunque altra cosa:

1. Crea ThemeRegistry (un enum con static var registry: [Theme: ThemeMetadata])
2. Chiama i 3 pack register(into:) in un blocco static func bootstrap()
3. Usa static func metadata(for theme: Theme) -> ThemeMetadata come accessor

enum ThemeRegistry {
    private static var registry: [Theme: ThemeMetadata] = {
        var dict: [Theme: ThemeMetadata] = [:]
        ThemeColorPack.register(into: &dict)
        ThemeIdentityPack.register(into: &dict)
        ThemeAnimatedPack.register(into: &dict)
        return dict
    }()

    static func metadata(for theme: Theme) -> ThemeMetadata {
        guard let meta = registry[theme] else {
            fatalError("ThemeRegistry: missing metadata for \(theme.rawValue)")
        }
        return meta
    }
}

---

Pattern di Progettazione Palette

Quando generi un tema da descrizione naturale (es. "un tema lava"), segui queste regole:

Colori

• Sfondo: sempre scuro (RGB < 0.20). Se .gradient, gradientTop 10-20% più scuro di gradientBottom
• Testo primario: bianco o quasi bianco (0.88-1.0)
• Testo secondario: ~65% dell'opacità del primario
• Accent glow: accentColor con opacità 0.14-0.26
• Card:
  • .elevated: surfaceColor ~2x brighter di backgroundPrimary
  • .cyber: surfaceColor ~1.5-2x brighter, dà effetto "vetro"
  • .flat: surfaceColor ~1.3x brighter, minimale

Icone (SF Symbols)

Scegli icona tematica. Esempi dai temi esistenti:

• water.waves, leaf.fill, sun.horizon.fill, moon.stars.fill
• shield.lefthalf.filled, sparkles, dial.high.fill, bolt.fill
• eye.slash.fill, cloud.sun.fill, dot.radiowaves.left.and.right
• antenna.radiowaves.left.and.right, party.popper.fill
• circle.dashed, terminal.fill, flame.fill, snowflake

Font

• Usa nil (system) per la maggior parte dei temi
• "Courier New" — militare, tecnico, industriale
• "Courier" — retro, vintage tech
• "Georgia" — elegante, naturale, classico
• "Menlo" — cyber, tech, moderno

Sound Pack

• "morse" — militare, tattico
• "synth" — retrowave, synthwave
• "glitch" — cyberpunk, hacker
• "sonar" — subacqueo, radar
• "radio" — radioamatore, vintage radio
• nil — per la maggior parte dei temi

---

Debug

Tema non si applica

1. Controlla UserDefaults.standard.string(forKey: "selected_theme")
2. Controlla bridge keys: fastboot_isProUser, fastboot_hasThemesPack
3. Verifica che il case enum sia in Theme.allCases

Build error: "ThemeRegistry"

C'è! È il bug noto. Crea ThemeRegistry come descritto sopra.

Animazione non parte

1. backgroundStyle == .animated nel metadata?
2. Caso switch in AnimatedBackgroundView.body?
3. reduceMotion non sta forzando la fallback statico?

Traduzione mancante

Le chiavi theme.name.hacker, theme.name.wildfire, theme.name.arctic mancano in TUTTE le 5 lingue. Vanno aggiunte.

---

Verifica Build

xcodebuild -project "WalkieTalkie.xcodeproj" -scheme WalkieTalkie -destination 'platform=iOS Simulator,name=iPhone 16' build 2>&1 | tail -20

---

Riepilogo Temi Esistenti

ID	Nome	Free/Pro	Stile sfondo	Font	Sound	Shader
default	Default	FREE	.solid	—	—	—
ocean	Ocean	Pro	.gradient	—	—	—
forest	Forest	Pro	.gradient	—	—	—
sunset	Sunset	Pro	.gradient	—	—	—
midnight	Midnight	Pro	.gradient	—	—	—
military	Military	Pro	.solid	Courier New	morse	—
retro80s	Retro 80s	Pro	.gradient	Courier	synth	—
vintageRadio	Vintage Radio	Pro	.solid	Georgia	—	—
cyberpunk	Cyberpunk	Pro	.gradient	Menlo	glitch	—
stealth	Stealth	Pro	.solid	Courier New	—	—
aurora	Aurora	Pro	.gradient	Georgia	—	—
submarine	Submarine	Pro	.gradient