admin/Reflect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add 100% localization coverage and App Store optimization docs

Browse Source 
- Add 4 missing strings to xcstrings (Watch complication, ContentView)
- Translate 112 strings to all 6 languages (de, es, fr, ja, ko, pt-BR)
- All 428 translatable strings now at 100% coverage
- Add ASO documentation: strategy, keywords, metadata, visual assets

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Trey t
2026-01-01 11:32:37 -06:00
parent 37fdb4db29
commit fa937793d9
5 changed files with 15311 additions and 9895 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24175
Feels/Localizable.xcstrings
View File

File diff suppressed because it is too large Load Diff

266
docs/ASO-Keywords.md Normal file
View File

@@ -0,0 +1,266 @@
# Feels App - Keyword Research & Strategy
## iOS App Store Keyword Strategy
### Keyword Field Constraints
- **Character Limit**: 100 characters
- **Format**: Comma-separated, no spaces after commas
- **Rules**: No duplicates from title/subtitle, no competitor names
---
## Keyword Research Framework
### 1. Seed Keywords (Core Terms)
| Keyword | Relevance | Est. Volume | Competition |
|---------|-----------|-------------|-------------|
| mood tracker | High | High | High |
| mood journal | High | Medium | Medium |
| mood diary | High | Medium | Medium |
| feelings tracker | High | Low | Low |
| emotion tracker | High | Low | Low |
| emotional health | High | Medium | Medium |
| mental health | High | Very High | Very High |
| daily mood | High | Medium | Low |
### 2. Feature-Based Keywords
| Feature | Keywords |
|---------|----------|
| Live Activities | live activity,lock screen,dynamic island |
| Widgets | mood widget,home screen widget |
| Apple Watch | watch mood,wrist,companion |
| Streaks | mood streak,daily streak,streak tracker |
| Journaling | mood notes,mood journal,diary |
| Customization | custom themes,personalize |
| Statistics | mood insights,patterns,analytics |
| Quick Entry | quick mood,one tap,fast log |
### 3. Benefit-Based Keywords
| Benefit | Keywords |
|---------|----------|
| Self-Awareness | self awareness,understand emotions,know yourself |
| Mental Wellness | mental wellness,emotional wellbeing,mindful |
| Habit Building | habit tracker,daily habit,routine |
| Privacy | private journal,secure diary |
| Simplicity | simple mood,easy tracker,minimalist |
### 4. Problem-Based Keywords (What Users Search)
| Problem | Keywords |
|---------|----------|
| Anxiety Management | anxiety tracker,stress monitor |
| Depression Tracking | depression log,mental health check |
| Therapy Support | cbt tracker,therapy journal,counseling |
| Self-Improvement | self improvement,personal growth |
| Emotional Regulation | manage emotions,emotional balance |
### 5. Long-Tail Opportunities
These lower-competition phrases can yield quick wins:
- daily mood check in
- mood tracker with widget
- simple mood diary
- mood tracker apple watch
- quick mood log
- emotional wellness app
- feelings journal
- mood tracker streak
- private mood diary
- mood calendar
---
## Recommended Keyword Field
### Primary Recommendation (100 characters)
```
mood,diary,journal,feelings,emotion,wellness,anxiety,streak,widget,mindful,cbt,self,health,log,daily
```
**Character Count**: 99 characters
### Alternative Option A (Focus on Features)
```
diary,journal,feelings,emotional,wellness,widget,streak,watch,log,calendar,daily,pattern,insight
```
### Alternative Option B (Focus on Mental Health)
```
diary,journal,feelings,anxiety,stress,wellness,mindful,cbt,therapy,depression,calm,daily,emotion
```
---
## Keywords by Priority Tier
### Tier 1: Must-Have (High Volume, High Relevance)
1. mood (in title)
2. tracker (in subtitle)
3. diary
4. journal
5. feelings
6. wellness
### Tier 2: Important (Medium Volume, High Relevance)
7. emotion / emotional
8. anxiety
9. streak
10. widget
11. daily
12. mindful
### Tier 3: Supporting (Lower Volume, Quick Wins)
13. cbt
14. self
15. health
16. log
17. pattern
18. insight
19. calendar
20. watch
---
## Localization Keywords
### German (DE)
```
Tagebuch,Stimmung,Gefuhle,Wohlbefinden,Angst,Widget,Gesundheit,Emotion,Tracker,taglich,Muster
```
### Spanish (ES)
```
diario,estado de animo,emociones,bienestar,ansiedad,rastreador,salud mental,sentimientos,habito
```
### French (FR)
```
journal,humeur,emotions,bien-etre,anxiete,suivi,sante mentale,sentiments,quotidien,widget
```
### Japanese (JA)
```
日記,気分,感情,メンタルヘルス,ウィジェット,習慣,ウェルネス,トラッカー,健康,毎日
```
### Korean (KO)
```
일기,기분,감정,정신건강,위젯,습관,웰니스,트래커,건강,매일
```
### Portuguese - Brazil (PT-BR)
```
diario,humor,emocoes,bem-estar,ansiedade,rastreador,saude mental,sentimentos,habito,widget
```
---
## Seasonal Keyword Opportunities
### January (New Year)
- new year resolution
- self improvement
- fresh start
- healthy habits
### May (Mental Health Awareness Month)
- mental health awareness
- mental wellness
- emotional support
- self care
### September (Back to School / Routine)
- daily routine
- habit tracker
- organize life
- productivity
### November-December (Holiday Stress)
- stress relief
- holiday anxiety
- manage stress
- emotional balance
---
## Competitor Keyword Intelligence
### Keywords Competitors Rank For
Based on analysis of Daylio, Moodistory, and Moodnotes:
| Keyword | Daylio | Moodistory | Feels Opportunity |
|---------|--------|------------|-------------------|
| mood tracker | #1 | #8 | Target Top 10 |
| mood journal | #2 | #5 | Target Top 10 |
| daily diary | #3 | #12 | Target Top 15 |
| feelings app | #15 | #20 | Win this keyword |
| emotion tracker | #8 | #18 | Win this keyword |
| streak tracker | N/A | N/A | Blue ocean |
| mood widget | #25 | #30 | Win this keyword |
| live activity | N/A | N/A | Blue ocean |
### Blue Ocean Keywords (Low Competition)
These keywords have low competition and Feels can potentially rank quickly:
1. **live activity mood** - No major competitors
2. **mood streak tracker** - Unique positioning
3. **control center mood** - Unique feature
4. **quick mood log** - Speed-focused users
5. **mood tracker widget** - Feature-specific
6. **lock screen mood** - Unique iOS 16+ feature
7. **mood dynamic island** - Latest iOS feature
---
## Keyword Tracking Plan
### Tools to Use
- App Store Connect (Search Ads metrics)
- AppTweak or MobileAction (competitive intelligence)
- SensorTower (market analysis)
### Weekly Checks
- [ ] Track ranking for top 20 keywords
- [ ] Monitor competitor keyword changes
- [ ] Identify rising/trending terms
- [ ] Check for seasonal opportunities
### Monthly Reviews
- [ ] Analyze keyword performance
- [ ] Drop underperforming keywords
- [ ] Add new opportunity keywords
- [ ] Update localization keywords
---
## Next Iteration Plan
After 2 weeks of data:
1. Identify keywords with impressions but low taps (improve creative)
2. Find keywords with high taps but low installs (improve page conversion)
3. Discover new keywords from Search Ads data
4. Test alternative keyword field combinations
---
*Research Sources*:
- [AppTweak ASO Blog](https://www.apptweak.com/en/aso-blog/)
- [MobileAction ASO Research](https://www.mobileaction.co/blog/)
- [SplitMetrics App Store Optimization](https://splitmetrics.com/blog/)
- Competitor App Store listings analysis
- Mental health app market research (2025-2026)
---
*Last Updated: January 2026*
*Version: 1.0*

261
docs/ASO-Metadata.md Normal file
View File

@@ -0,0 +1,261 @@
# Feels App - Optimized App Store Metadata
## App Name Options
### iOS App Store Constraints
- **Character Limit**: 30 characters
- **Best Practice**: Brand + Primary Keyword
- **Current Name**: iFeels / Feels
---
### Recommended App Names
#### Primary Recommendation
```
Feels: Mood Tracker & Journal
```
**Characters**: 28/30
**Rationale**: Includes brand, primary keyword (mood tracker), and secondary keyword (journal)
#### Alternative Options
| Option | Characters | Pros | Cons |
|--------|------------|------|------|
| `Feels - Daily Mood Tracker` | 26 | Clear value prop | Less unique |
| `Feels: Mood Diary & Streak` | 27 | Highlights streak feature | "Diary" less searched than "tracker" |
| `Feels - Mood Journal` | 20 | Simple, clean | Missing "tracker" keyword |
| `Feels: Track Your Mood` | 23 | Action-oriented | Generic phrasing |
| `Feels - Mood & Wellness Log` | 28 | Wellness angle | May be too broad |
---
## Subtitle Options
### iOS App Store Constraints
- **Character Limit**: 30 characters
- **Best Practice**: Unique keywords not in title + benefit statement
---
### Recommended Subtitles
#### Primary Recommendation
```
Widget, Streaks & Live Activity
```
**Characters**: 30/30
**Rationale**: Highlights unique differentiators (widgets, streaks, Live Activity)
#### Alternative Options
| Option | Characters | Focus |
|--------|------------|-------|
| `Daily Check-in with Streaks` | 27 | Habit/routine focus |
| `Quick Log from Lock Screen` | 26 | Speed/convenience focus |
| `Track Emotions, Build Habits` | 28 | Dual benefit focus |
| `Simple Wellness Tracker` | 23 | Simplicity focus |
| `Watch, Widget & Live Activity` | 29 | Apple ecosystem focus |
| `Log Moods in One Tap` | 20 | Speed focus |
| `Private Daily Mood Diary` | 24 | Privacy focus |
---
## Short Description (Promotional Text)
### iOS Constraints
- **Character Limit**: 170 characters
- **Note**: Can be changed without app review
### Recommended Promotional Text
```
Track your daily mood in seconds from anywhere - your Lock Screen, Widget, Apple Watch, or Siri. Build streaks, spot patterns, and understand your emotional wellness journey.
```
**Characters**: 170/170
#### Seasonal Variations
**New Year (January)**
```
Start your wellness journey this year! Track daily moods, build streaks, and discover patterns. Log from Widget, Lock Screen, or Apple Watch. Your emotional health companion.
```
**Mental Health Awareness (May)**
```
Take care of your mental health one day at a time. Track moods from Lock Screen or Widget, build streaks, and understand your patterns. Your private wellness companion.
```
---
## Long Description
### iOS Constraints
- **Note**: Not indexed for keywords (use for conversion only)
- **Goal**: Convert browsers into downloaders
---
### Recommended App Store Description
```
Understand your emotions. One tap at a time.
Feels makes mood tracking effortless. Log how you're feeling in just one second from your Lock Screen, Widget, Apple Watch, Control Center, or through Siri. No friction, no complicated forms - just quick check-ins that build into powerful insights.
WHY FEELS?
Log Moods From Anywhere
- Live Activity on your Lock Screen
- Dynamic Island integration
- Home Screen widgets (small, medium, large)
- Apple Watch companion app
- Control Center quick action
- Siri Shortcuts
- Daily notification reminders
Build Consistency With Streaks
Keep your streak alive and watch your commitment grow. Our streak system motivates you to check in daily, turning mood tracking into a rewarding habit.
Customize Everything
- 4 beautiful themes: System, iFeel, Dark, Light
- 4 color palettes: Default, Neon, Pastel, or create your own
- Personalized widget designs
- Choose your daily check-in time
Journal Your Journey
Add notes and photos to any mood entry. Look back and remember what made you feel great - or understand what triggered a tough day.
Discover Patterns
View your mood history in a beautiful calendar. See weekly, monthly, and yearly trends. Export your data anytime.
Private & Secure
Your moods are synced securely through iCloud - no third-party servers, no accounts to create. Your emotional data stays yours.
FEATURES AT A GLANCE
- 5 mood levels from Great to Horrible
- Multiple logging methods (9 ways to log!)
- Streak tracking with motivation
- Notes and photo journaling
- Beautiful statistics and insights
- iCloud sync across all your Apple devices
- 7 languages supported
- Fully customizable appearance
- Apple Watch companion app
- iOS 14+ widget support
- Live Activities (iOS 16+)
START YOUR WELLNESS JOURNEY
Download Feels today and take the first step toward understanding your emotional patterns. Whether you're tracking for mental wellness, building better habits, or simply curious about your emotional life - Feels is your companion.
Premium Subscription:
- Unlock all customization options
- Priority support
- Monthly: $0.99/month
- Yearly: $9.99/year (save over 15%)
Questions or feedback? We'd love to hear from you!
```
---
## Localized Metadata
### German (DE)
**Title**: `Feels: Stimmungstracker`
**Subtitle**: `Widget, Streaks & Tagebuch`
**Promotional Text**:
```
Tracke deine Stimmung in Sekunden - vom Sperrbildschirm, Widget oder der Apple Watch. Baue Streaks auf und verstehe deine emotionalen Muster.
```
### Spanish (ES)
**Title**: `Feels: Estado de Animo`
**Subtitle**: `Widget, Rachas y Diario`
**Promotional Text**:
```
Registra tu estado de animo en segundos desde cualquier lugar - pantalla de bloqueo, widget o Apple Watch. Crea rachas y descubre tus patrones.
```
### French (FR)
**Title**: `Feels: Suivi d'Humeur`
**Subtitle**: `Widget, Series et Journal`
**Promotional Text**:
```
Suivez votre humeur en quelques secondes depuis l'ecran de verrouillage, le widget ou l'Apple Watch. Construisez des series et comprenez vos emotions.
```
### Japanese (JA)
**Title**: `Feels: 気分トラッカー`
**Subtitle**: `ウィジェット＆日記`
**Promotional Text**:
```
ロック画面、ウィジェット、Apple Watchからワンタップで気分を記録。ストリークを続けて、感情のパターンを理解しましょう。
```
### Korean (KO)
**Title**: `Feels: 기분 트래커`
**Subtitle**: `위젯, 연속기록 및 일기`
**Promotional Text**:
```
잠금화면, 위젯, Apple Watch에서 탭 한 번으로 기분을 기록하세요. 연속 기록을 유지하고 감정 패턴을 파악하세요.
```
### Portuguese - Brazil (PT-BR)
**Title**: `Feels: Rastreador Humor`
**Subtitle**: `Widget, Sequencias e Diario`
**Promotional Text**:
```
Registre seu humor em segundos de qualquer lugar - tela de bloqueio, widget ou Apple Watch. Mantenha sequencias e entenda seus padroes emocionais.
```
---
## What's New (Release Notes)
### Version 1.0.2 Template
```
Thank you for using Feels!
This update includes:
- Improved widget layout for small size
- Better settings visibility in light mode
- Month view now shows real data
- All 5 moods included in exports
- Enhanced color themes
- Better text contrast for mood colors
- Full-screen theme preview
We're constantly improving Feels based on your feedback. If you enjoy the app, please consider leaving a review - it helps others discover us!
```
---
## A/B Testing Priorities
### Test 1: App Name
- A: `Feels: Mood Tracker & Journal`
- B: `Feels - Daily Mood Tracker`
### Test 2: Subtitle
- A: `Widget, Streaks & Live Activity`
- B: `Quick Log from Lock Screen`
### Test 3: First Screenshot
- A: Live Activity focus
- B: Widget focus
- C: Speed of logging focus
---
*Last Updated: January 2026*
*Version: 1.0*

152
docs/ASO-Strategy.md Normal file
View File

@@ -0,0 +1,152 @@
# Feels App - App Store Optimization Strategy
## Executive Summary
Feels is a mood tracking app for iOS, watchOS, and macOS with strong differentiating features including Live Activities, customizable widgets, multiple entry points (Siri, Control Center, Watch), streak tracking, and journaling capabilities. This document outlines a comprehensive ASO strategy to maximize organic visibility and conversions.
---
## Current App Analysis
### Unique Value Propositions
1. **Multi-Platform Support**: iOS, watchOS, and macOS with iCloud sync
2. **Live Activities**: Lock Screen and Dynamic Island streak tracking
3. **9 Entry Points**: Log moods from anywhere (App, Widget, Watch, Siri/Shortcuts, Notifications, Control Center, Live Activity, Header, Filled-in Missing)
4. **Customization**:
- 4 app themes (System, iFeel, Dark, Light)
- 4 color palettes (Default, Neon, Pastel, Custom)
- Fully customizable widgets
5. **Streak Tracking**: Built-in motivation system
6. **Journaling**: Notes and photo attachments
7. **Statistics & Insights**: Mood metrics and patterns
8. **7 Languages**: EN, DE, ES, FR, JA, KO, PT-BR
9. **Privacy First**: iCloud sync (no third-party servers)
### Current Positioning
- **App Name**: iFeels / Feels
- **Bundle ID**: com.tt.ifeel
- **Version**: 1.0.2
- **Monetization**: Subscription ($0.99/month or $9.99/year)
---
## Competitive Landscape
### Direct Competitors
| App | Key Strength | Weakness vs. Feels |
|-----|-------------|-------------------|
| Daylio | Market leader, no-typing interface | No Live Activities, limited customization |
| Moodistory | Beautiful design, PDF export | Less entry points |
| Moodnotes | CBT-focused, psychology-backed | More complex, therapy-focused |
| Reflectly | AI journaling | Heavy on journaling, less on tracking |
| Bearable | Comprehensive health tracking | Overwhelming for simple mood tracking |
### Competitive Advantages of Feels
1. **Live Activities** - Unique differentiator (few/no competitors have this)
2. **Control Center integration** - Fastest logging possible
3. **Extensive customization** - Appeals to personalization-focused users
4. **Apple Watch companion** - Seamless ecosystem integration
5. **Streak gamification** - Retention mechanism
6. **Lightweight** - Fast, focused on one thing
---
## Target Audience
### Primary Personas
1. **Self-Improvement Seeker** (25-40)
- Wants to understand emotional patterns
- Values data and insights
- Uses iPhone + Apple Watch
- Keywords: mood tracking, self-awareness, patterns
2. **Mental Wellness Enthusiast** (18-35)
- Proactively managing mental health
- Uses apps for daily routines
- Appreciates beautiful design
- Keywords: mental health, emotional wellness, daily check-in
3. **Habit Builder** (20-45)
- Building consistent habits
- Motivated by streaks
- Wants friction-free logging
- Keywords: daily habit, streak, quick logging
4. **Apple Ecosystem Power User** (25-50)
- Uses all Apple devices
- Values native integrations
- Cares about privacy
- Keywords: Apple Watch, widget, iCloud sync
---
## Strategic Recommendations
### Immediate Actions (Week 1-2)
1. **Optimize App Name and Subtitle** (See ASO-Metadata.md)
2. **Revise Keyword Field** for maximum coverage
3. **Update Screenshots** to highlight Live Activities and customization
4. **Craft Compelling Description** focused on benefits
### Short-Term (Month 1)
1. **Localize Metadata** for DE, ES, FR, JA, KO, PT-BR markets
2. **Create App Preview Video** showcasing speed of logging
3. **A/B Test Icons** using App Store Connect experiments
4. **Implement Review Prompts** at optimal moments (after streaks, positive moods)
### Medium-Term (Month 2-3)
1. **Target Seasonal Keywords** (New Year resolutions, Mental Health Awareness Month)
2. **Build Review Velocity** through in-app prompts
3. **Analyze Search Ads Intelligence** to discover new keywords
4. **Iterate Based on Data** from A/B tests
### Long-Term (Ongoing)
1. **Weekly Keyword Ranking Monitoring**
2. **Monthly Competitor Analysis**
3. **Quarterly Metadata Refreshes**
4. **Continuous A/B Testing**
---
## Key Performance Indicators
| Metric | Current | 30-Day Target | 90-Day Target |
|--------|---------|---------------|---------------|
| Keyword Rankings (Top 10) | TBD | +5 keywords | +15 keywords |
| Impression-to-Install Rate | TBD | +10% | +25% |
| Average Rating | TBD | 4.5+ | 4.7+ |
| Review Velocity | TBD | 10/week | 25/week |
| Organic Downloads | TBD | +25% | +100% |
---
## Risk Mitigation
1. **Algorithm Changes**: Diversify keyword strategy, don't rely on single terms
2. **Competitor Movements**: Monitor weekly, prepare counter-strategies
3. **Negative Reviews**: Implement quick response system
4. **Seasonality**: Plan content calendar around mental health awareness periods
---
## Next Steps
1. Review and implement metadata suggestions in `ASO-Metadata.md`
2. Conduct keyword research using tools mentioned in `ASO-Keywords.md`
3. Create visual assets following `ASO-Visual-Assets.md` guidelines
4. Set up tracking and monitoring systems
5. Schedule first iteration review for 2 weeks post-launch
---
*Last Updated: January 2026*
*Version: 1.0*

352
docs/ASO-Visual-Assets.md Normal file
View File

@@ -0,0 +1,352 @@
# Feels App - Visual Asset Optimization Guide
## Overview
Visual assets account for a significant portion of App Store conversion. This guide provides recommendations for screenshots, app preview videos, and app icon optimization.
---
## Screenshot Strategy
### iOS Screenshot Requirements
| Device | Size | Quantity |
|--------|------|----------|
| iPhone 6.7" | 1290 x 2796 | Up to 10 |
| iPhone 6.5" | 1242 x 2688 | Up to 10 |
| iPhone 5.5" | 1242 x 2208 | Up to 10 |
| iPad Pro 12.9" | 2048 x 2732 | Up to 10 |
**Minimum Required**: 3 screenshots per device
**Recommended**: 6-8 screenshots (first 3 are most critical)
---
## Screenshot Sequence (Recommended Order)
### Screenshot 1: Hero Shot - Live Activity
**Goal**: Immediately differentiate from competitors
**Visual Elements**:
- iPhone showing Lock Screen with Live Activity
- Dynamic Island visible at top
- Mood streak prominently displayed
- Caption: "Track moods from your Lock Screen"
**Color Scheme**: Use the Neon or iFeel theme for visual pop
---
### Screenshot 2: Widget Showcase
**Goal**: Show home screen integration
**Visual Elements**:
- Home screen with small, medium, and large widgets
- Custom widget design visible
- Beautiful background
- Caption: "Beautiful widgets that fit your style"
**Tip**: Show the customizable nature of widgets
---
### Screenshot 3: One-Tap Logging
**Goal**: Emphasize speed and simplicity
**Visual Elements**:
- Main mood selection interface
- 5 mood options clearly visible
- Finger/tap indication optional
- Caption: "Log your mood in one tap"
**Tip**: Keep it clean and focused on the simplicity
---
### Screenshot 4: Streak & Motivation
**Goal**: Show the gamification element
**Visual Elements**:
- Streak counter prominently displayed
- Calendar view with logged days
- Achievement or milestone indication
- Caption: "Build streaks, build habits"
---
### Screenshot 5: Calendar & Insights
**Goal**: Demonstrate the value of tracking over time
**Visual Elements**:
- Month view calendar with color-coded moods
- Pattern visualization
- Statistics or metrics visible
- Caption: "Discover your emotional patterns"
---
### Screenshot 6: Customization
**Goal**: Appeal to personalization-focused users
**Visual Elements**:
- Theme selection screen OR
- Color palette customization
- Multiple theme examples side by side
- Caption: "Customize every detail"
---
### Screenshot 7: Apple Watch
**Goal**: Showcase ecosystem integration
**Visual Elements**:
- Apple Watch showing the Feels app
- Mood logging interface on watch
- iPhone optional in background
- Caption: "Log moods from your wrist"
---
### Screenshot 8: Journaling
**Goal**: Show depth beyond basic tracking
**Visual Elements**:
- Note entry interface
- Photo attachment visible
- Rich entry example
- Caption: "Add notes and photos to remember why"
---
## Screenshot Design Guidelines
### Typography
- **Headlines**: Bold, 60-80pt, high contrast
- **Subheadlines**: Medium weight, 36-48pt
- **Placement**: Top third of screenshot (visible above fold)
- **Color**: White text on dark overlays OR dark text on light overlays
### Layout Principles
1. Device at center or slightly right
2. Text above or beside device
3. Background should complement app theme
4. Consistent spacing across all screenshots
### Color Recommendations
| Theme Option | Background | Text |
|--------------|------------|------|
| Dark/Neon | Dark purple/blue gradient | White or Neon colors |
| Light/Pastel | Light gradient or solid | Dark gray or black |
| System | Match iOS system colors | High contrast |
### Do's and Don'ts
**Do**:
- Show actual app UI (builds trust)
- Use consistent visual language
- Highlight unique features first
- Keep text concise (3-5 words per headline)
- Test different concepts
**Don't**:
- Use generic stock imagery
- Overcrowd with text
- Show competitor comparisons
- Use tiny, unreadable text
- Forget to optimize for dark mode users
---
## App Preview Video
### Specifications
- **Length**: 15-30 seconds (recommend 20-25 seconds)
- **Format**: H.264, 30fps
- **Resolution**: Match screenshot sizes
### Recommended Video Structure
| Time | Content | Goal |
|------|---------|------|
| 0-3s | Logo + hook | Grab attention |
| 3-8s | Live Activity logging | Show unique feature |
| 8-13s | Widget interaction | Show convenience |
| 13-18s | Streak/Calendar view | Show value over time |
| 18-22s | Customization montage | Show personalization |
| 22-25s | CTA + App Icon | Drive download |
### Script Concept
```
[0-3s]
Visual: Feels logo animates in
Text: "Track moods in seconds"
[3-8s]
Visual: Lock Screen -> Live Activity tap -> Mood logged
Text: "From your Lock Screen"
[8-13s]
Visual: Home screen -> Widget tap -> Mood selection
Text: "Or your Home Screen"
[13-18s]
Visual: Calendar fills with color-coded moods
Text: "Build streaks. See patterns."
[18-22s]
Visual: Quick cuts of different themes/colors
Text: "Make it yours"
[22-25s]
Visual: App icon with download CTA
Text: "Download Feels today"
```
### Audio Recommendations
- Use subtle, upbeat background music
- No voiceover needed (text overlays are clearer)
- Music should not be copyrighted
- Consider using audio that evokes calm/wellness
---
## App Icon Optimization
### Current Analysis
The app likely uses a mood-related icon. Key considerations:
### Icon Design Principles
1. **Simplicity**: One recognizable element
2. **Distinctiveness**: Stand out in the grid
3. **Scalability**: Work at all sizes (1024px down to 58px)
4. **Brand Consistency**: Match app theme/colors
### A/B Test Concepts
| Concept | Description | Target Audience |
|---------|-------------|-----------------|
| A | Abstract smiley face | Broad appeal |
| B | Gradient orb/circle | Modern/minimal |
| C | "F" with mood colors | Brand-focused |
| D | Calendar with mood | Feature-focused |
### Color Psychology
| Color | Emotion | When to Use |
|-------|---------|-------------|
| Green | Growth, wellness | Primary feel |
| Blue | Trust, calm | Professional feel |
| Purple | Creativity, luxury | Premium feel |
| Multi-color gradient | Variety, expression | Emotional range |
### Icon Testing Strategy
1. Create 3-4 icon variations
2. Test using App Store Connect's Product Page Optimization
3. Run for minimum 7 days
4. Measure tap-through rate differences
5. Implement winner, iterate
---
## iPad Screenshots
### Additional Considerations
- Show split-screen potential if applicable
- Emphasize larger widgets
- Demonstrate calendar view advantage on bigger screen
- Consider landscape orientation for productivity angle
---
## Dark Mode Considerations
- Ensure screenshots look good on both light and dark App Store
- Test how your screenshots appear in different contexts
- Consider creating separate light/dark versions for testing
---
## Seasonal Visual Updates
### New Year (December-January)
- Add "Start fresh" messaging
- New year resolution angle
- Fresh, clean visual style
### Mental Health Awareness Month (May)
- Green ribbon subtle integration
- Wellness-focused messaging
- Calming color palette
### Back to School (August-September)
- Routine/habit angle
- Organization messaging
- Structured visual style
---
## Screenshot Production Checklist
### Pre-Production
- [ ] Define 6-8 screenshot concepts
- [ ] Write headline copy for each
- [ ] Choose color palette/theme
- [ ] Prepare actual app screens
### Production
- [ ] Capture high-res app screenshots
- [ ] Design frames and backgrounds
- [ ] Add device frames if needed
- [ ] Add text overlays
- [ ] Create all required sizes
### Post-Production
- [ ] Review on actual devices
- [ ] Test in App Store context
- [ ] Get external feedback
- [ ] Prepare A/B test variants
- [ ] Document and organize assets
---
## Recommended Tools
### Design
- Figma (free, collaborative)
- Sketch (Mac, one-time purchase)
- Adobe XD (subscription)
### Screenshot Generators
- AppMockUp (web-based)
- Rotato (3D device mockups)
- Screenshot Designer (templates)
### Video
- iMovie (free, macOS)
- Final Cut Pro (professional)
- After Effects (motion graphics)
---
## Measurement & Iteration
### Key Metrics
- **Impression-to-Product-Page-View Rate**: Do screenshots attract clicks?
- **Product-Page-View-to-Install Rate**: Do screenshots convert?
- **First Screenshot Drop-off**: Are users scrolling?
### Testing Cadence
- Test new screenshots every 4-6 weeks
- Run each test for minimum 7 days
- Document all test results
- Iterate based on data, not assumptions
---
*Last Updated: January 2026*
*Version: 1.0*