# Walkietalkie Themes

> Walkietalkie Themes is an Agent Skill for design published in the andreapianidev/WalkieTalkie repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

- Skill name: `walkietalkie-themes`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/andreapianidev/WalkieTalkie/blob/HEAD/.opencode/skills/walkietalkie-themes/SKILL.md
- Repository: andreapianidev/WalkieTalkie (342 GitHub stars when collected)

## SKILL.md

# 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

```swift
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

```bash
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` | — | sonar | — |
| `hamRadio` | HAM Radio | Pro | `.solid` | Courier New | radio | — |
| `festival` | Festival | Pro | `.gradient` | Menlo | — | — |
| `blackHole` | Black Hole | Pro | `.animated` | — | — | 70 particelle spirale |
| `galaxy` | Galaxy | Pro | `.animated` | — | — | 110 stelle + 8 cadenti |
| `hacker` | Hacker | Pro | `.solid` | Menlo | glitch | — |
| `wildfire` | Wildfire | Pro | `.gradient` | Courier New | — | — |
| `arctic` | Arctic | Pro | `.gradient` | Georgia | — | — |

---

Source: https://www.openparable.com/skill/design/walkietalkie-themes (OpenParable). Cite the canonical URL above.
