Add 100% localization coverage and App Store optimization docs

- 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>
2026-01-01 11:32:37 -06:00
parent 37fdb4db29
commit fa937793d9
5 changed files with 15311 additions and 9895 deletions
--- a/docs/ASO-Keywords.md
+++ b/docs/ASO-Keywords.md
@@ -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*