walkietalkie-themes

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

---

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