# Template Guide — Shotkit
## Choosing a Template
| Template | Best For | Vibe |
|----------|---------|------|
| `trending` | Any app | Auto-styled with curated trending palettes |
| `minimal` | Productivity, utilities, finance | Clean, trustworthy |
| `bold` | Games, lifestyle, fitness | Energetic, vibrant |
| `dark` | Pro tools, music, photography | Luxury, premium |
| `editorial` | Creative, travel, shopping | Magazine, editorial |
| `flat` | Photo/video, maps, AR | Immersive, UI-first |
## trending (recommended)
- Data-driven renderer based on top-charting App Store apps
- 10 curated palettes: aurora, sunset-pop, midnight, ocean, coral, forest, neon, slate, peach, electric
- Auto-palette from app icon: `--icon ./icon.png`
- Custom brand color: `--brand-color "#1E90FF"`
- Specific palette: `--palette aurora`
- Run `shotkit palettes` to list all available palettes
## minimal
- Background: #F8F8F8
- UI: top 68% of canvas, rounded frame + shadow
- Text: below device, headline then subline
## bold
- Background: full-bleed gradient (deep blue → purple by default)
- Text: TOP of canvas
- UI: bottom 62%, rounded top corners
- Customize gradient in render_bold() in generate_screenshots.py
## dark
- Background: #0A0A0E near-black
- Colored glow halo behind device (default: blue)
- Text: below device
## editorial
- Background: #F5F2EE warm paper
- Left accent strip (default: red #FF5040)
- UI: right side, text: left side
## flat
- Full-bleed UI fills entire canvas
- Semi-transparent dark bar at bottom with text
- Best when your UI is visually stunning
## Device Frames
Add realistic Apple device bezels around the UI screenshot with `--frame device`:
```bash
shotkit generate --app-name "MyApp" --captures ./raw --template minimal --frame device
shotkit generate --app-name "MyApp" --captures ./raw --template bold --frame device --frame-color black-titanium
```
**Available frame colors:**
| Color | RGB | Best For |
|-------|-----|----------|
| `black-titanium` | (60, 60, 61) | Dark/bold templates |
| `natural-titanium` | (194, 188, 178) | Minimal/editorial templates |
| `white-titanium` | (242, 241, 237) | Light backgrounds |
| `desert-titanium` | (191, 164, 143) | Warm/editorial templates |
| `space-black` | (45, 45, 47) | iPad on dark backgrounds |
| `silver` | (210, 211, 213) | iPad on light backgrounds |
Frames include:
- Realistic bezel thickness and corner radii
- Dynamic Island (iPhone 14+/15/16)
- Notch (iPhone 6.5")
- Side buttons (power, volume, action)
- Proper screen insets
Default: `natural-titanium` for iPhones, `space-black` for iPads.
## Custom Fonts
Add any .ttf to assets/fonts/ and update _get_font() in generate_screenshots.py.
Good free options: Inter, Space Grotesk, Sora, Outfit, Plus Jakarta Sans