# Sound Effects for CasinoKit

## Required Sound Files

Add the following `.mp3` files to this folder:

| Filename | Description | When Played |
|----------|-------------|-------------|
| `chip_place.mp3` | Chip clicking sound | When placing a bet |
| `chip_stack.mp3` | Multiple chips clinking | When stacking chips |
| `card_deal.mp3` | Card sliding/dealing sound | When each card is dealt |
| `card_flip.mp3` | Card flip/reveal sound | When cards are turned face up |
| `card_shuffle.mp3` | Deck shuffling sound | When deck is shuffled (optional) |
| `win.mp3` | Victory/success sound | When player wins |
| `lose.mp3` | Loss sound (subtle) | When player loses |
| `push.mp3` | Neutral/tie sound | When result is a tie/push |
| `big_win.mp3` | Big win celebration | For large payouts |
| `button_tap.mp3` | UI tap feedback | When buttons are tapped |
| `new_round.mp3` | Fresh start sound | When starting a new round |
| `clear_bets.mp3` | Chips sliding/removing | When clearing bets |
| `game_over.mp3` | Sad/failure sound | When player runs out of chips |

## Free Sound Resources

### Casino & Card Game Sounds

1. **Freesound.org** (Free, requires attribution)
   - Search: "casino chips", "card dealing", "poker"
   - High quality community-contributed sounds
   - https://freesound.org

2. **Mixkit** (Free, no attribution required)
   - Casino and game sound effects
   - https://mixkit.co/free-sound-effects/casino/

3. **Zapsplat** (Free with account)
   - Large library of casino sounds
   - https://www.zapsplat.com

4. **Soundsnap** (Subscription/paid)
   - Professional quality sounds
   - https://www.soundsnap.com

5. **Epidemic Sound** (Subscription)
   - High-quality licensed sounds
   - https://www.epidemicsound.com

### Recommended Search Terms

- "casino chip" or "poker chip"
- "card deal" or "card slide"
- "card flip" or "card turn"
- "win jingle" or "success sound"
- "game over" or "fail sound"
- "casino ambience" (for background)

## Tips for Good Sound Selection

1. **Keep it subtle** - Sounds should enhance, not distract
2. **Short duration** - 0.2-1.5 seconds is ideal for most effects
3. **Consistent volume** - Normalize all sounds to similar levels
4. **High quality** - Use 44.1kHz sample rate minimum
5. **Mobile-friendly** - MP3 format, reasonable file sizes (<500KB each)

## Implementation Notes

- The `SoundManager` class preloads all sounds at app launch
- Missing sound files are handled gracefully (no crash)
- Volume is controllable from Settings
- Sounds respect the user's sound/haptic preferences

## Adding Sound Files

1. Add `.mp3` files to this `Sounds` folder in CasinoKit
2. The Package.swift already includes Resources, so files are automatically bundled
3. Build and run - sounds should work automatically
4. If sounds are in your app bundle instead, set `SoundManager.shared.soundBundle = .main`

## Testing

Run the app and:
1. Place a bet → hear chip sound
2. Deal cards → hear deal/flip sounds
3. See result → hear win/lose/push sound
4. New round → hear new round sound
5. Clear bets → hear clear sound

