9cadc1ad18
- dish_added now carries a `source` param; onboarding-created dishes fire it with source="onboarding" (previously untracked, undercounting activation) - onboarding_completed now reports dish_count - premium_purchased tagged with StoreKit environment (production/sandbox/xcode) so test purchases can be excluded from conversion metrics - add .gitignore to keep signing secrets (.p12/.cer/.mobileprovision) and build artifacts out of the repo - document branch↔MARKETING_VERSION naming convention Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UtWT52pAE91D7mbDda1cAM
3.1 KiB
3.1 KiB
MealMood — Project Context for Claude Code
App
- Name: MealMood: Family Meal Planner
- Bundle ID: com.alexandrevazquez.mealmood
- Platform: iOS/iPadOS (also runs as iOS app on Mac)
- Current version: 1.1.5
- Main branch:
1.0.1(production), feature branches named after versions
Branch ↔ version convention (IMPORTANT)
The active dev branch is named after the current MARKETING_VERSION, not the one it was created with. Whenever the iOS app version changes, rename the branch to match:
# after bumping MARKETING_VERSION in the Xcode project to e.g. 1.1.6
git branch -m <old-version> 1.1.6 # e.g. git branch -m 1.1.5 1.1.6
Right now: MARKETING_VERSION = 1.1.5 → active branch is 1.1.5. Keep them in sync. (The build number bump within the same version does NOT rename the branch — only a version change does.)
Credentials — all managed via pass (GPG-encrypted, syncs to Gitea)
Never hardcode credentials. Always read from pass:
# Apple
pass show apple/mealmood/apple-id # alexandre.vazquez@gmail.com
pass show apple/mealmood/developer-team-id # 2825Q76T7H
pass show apple/mealmood/appstore-connect-team-id # 128443966
pass show apple/mealmood/app-store-app-id # 6759255553
pass show apple/mealmood/app-specific-password-fastlane # for fastlane uploads
# Firebase
pass show firebase/mealmood/api-key
pass show firebase/mealmood/project-id
pass show firebase/mealmood/google-app-id
# AdMob
pass show admob/mealmood/app-id
pass show admob/mealmood/banner-home-unit-id
TestFlight upload
export FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=$(pass show apple/mealmood/app-specific-password-fastlane)
fastlane beta
Stack
- SwiftUI + SwiftData (iOS 17+)
- Firebase Analytics (
AnalyticsService.swift) - Google AdMob (banner, free tier only, hidden on Mac)
- StoreKit 2 (subscription
com.mealmood.premium.monthly) - iCloud KV sync (
ICloudSyncService.swift) — does NOT syncisPremium - Widget extension (
MealMoodWidget/) — requires App Groupgroup.com.alexandrevazquez.mealmood - Fastlane for CI/CD
Premium logic
PremiumSyncServiceis the source of truth for premium state transitionsisPremiumis determined only by StoreKit — never by iCloud syncTransaction.updateslistener inContentViewcatches purchases in real-time- Tests:
MealMoodTests/PremiumSyncServiceTests.swift
Key files
| File | Purpose |
|---|---|
MealMood/ContentView.swift |
App root, premium sync, Transaction.updates listener |
MealMood/Services/PremiumSyncService.swift |
Premium state machine (testable) |
MealMood/Services/StoreManager.swift |
StoreKit 2 purchase/restore |
MealMood/Services/ICloudSyncService.swift |
Cross-device sync (dishes, tags, plans — NOT isPremium) |
MealMood/Views/Home/WeekPlanShareView.swift |
Export styles (default, school, vertical A4) |
MealMoodWidget/MealMoodWidget.swift |
Home screen widget |
fastlane/Fastfile |
beta and release lanes |
fastlane/metadata/ |
App Store metadata in 6 languages |