📱 BMad Mobile Dev Module

BMAD™ Module for React Native & Expo Mobile Development

Complete toolkit for developing, testing, building, and releasing React Native/Expo mobile applications.

---

🎯 Purpose

This module provides specialized agents, tasks, and workflows for:

• Mobile app development (iOS & Android)
• Local device testing
• EAS cloud builds
• TestFlight & Play Store deployments
• Release management
• Version control
• Performance optimization

---

🚀 Quick Start

Activate Release Manager

/release

Then use commands like:

• *test-local - Test on connected device
• *build-preview - Create preview build for testing
• *testflight - Deploy to TestFlight
• *version - Manage version numbers
• *status - Check release status

---

📦 Module Structure

bmad-mobile-dev-module/
├── .bmad-core/
│   ├── agents/           # Specialized development agents
│   │   └── release-manager.md
│   ├── tasks/            # Executable workflows
│   │   ├── test-on-device.md
│   │   ├── build-preview.md
│   │   └── deploy-testflight.md
│   ├── checklists/       # Quality gates
│   │   └── pre-release-checklist.md
│   ├── templates/        # Reusable templates
│   └── data/             # Reference data
├── README.md
└── package.json

---

🤖 Agents

Release Manager (release-manager.md)

Purpose: Complete release cycle management from dev to production

Capabilities:

• Local device testing (iOS & Android)
• EAS preview & production builds
• TestFlight deployment
• Play Store deployment
• Version management
• Changelog generation
• Release notes creation

Commands:

• *test-local - Test on physical device
• *build-preview - Internal test build
• *build-production - Production build
• *testflight - Deploy to TestFlight
• *playstore - Deploy to Play Store
• *version - Bump version numbers
• *changelog - Generate changelog
• *release-notes - Create store release notes
• *status - Current release status

---

📋 Tasks

test-on-device.md

Install and test app on connected iOS or Android device

Usage:

# iOS
npx expo run:ios --device

# Android
npx expo run:android --device

build-preview.md

Create preview/internal test build using EAS

Usage:

cd apps/mobile
npx eas build --profile preview --platform ios

deploy-testflight.md

Submit iOS build to Apple TestFlight

Usage:

cd apps/mobile
npx eas submit --platform ios --latest

---

✅ Checklists

pre-release-checklist.md

Complete this before any build:

• All tests passing
• No TypeScript errors
• Assets validated
• Version updated
• Changelog updated
• Tested on devices

---

🔧 Setup

Prerequisites

Required:

• Node.js 18+
• npm 9+
• EAS CLI: npm install -g eas-cli
• Expo account

For iOS:

• macOS
• Xcode
• Apple Developer account ($99/year)

For Android:

• Android Studio
• Google Play Developer account ($25 one-time)

Installation

1. Clone Module:

cd /path/to/your/project
git clone https://github.com/yourusername/bmad-mobile-dev-module .bmad-mobile-dev

2. Link to Project:

# Create symlink in your project
ln -s /path/to/bmad-mobile-dev-module .bmad-mobile-dev

3. Configure EAS:

cd apps/mobile
eas build:configure

---

📱 Workflows

Development Testing

┌─────────────────────────────────────┐
│   LOCAL DEVELOPMENT TESTING         │
├─────────────────────────────────────┤
│                                      │
│  1. npm run mobile                  │
│     ↓                                │
│  2. Scan QR with Expo Go            │
│     ↓                                │
│  3. Test on physical device         │
│     ↓                                │
│  4. Fix issues                       │
│     ↓                                │
│  5. Ready for preview build          │
│                                      │
└─────────────────────────────────────┘

Preview Build & Testing

┌─────────────────────────────────────┐
│   PREVIEW BUILD WORKFLOW             │
├─────────────────────────────────────┤
│                                      │
│  1. *build-preview                  │
│     ↓                                │
│  2. EAS builds app (10-15 min)     │
│     ↓                                │
│  3. Download & install on devices   │
│     ↓                                │
│  4. Internal team testing           │
│     ↓                                │
│  5. Collect feedback                │
│     ↓                                │
│  6. Fix issues                       │
│     ↓                                │
│  7. Ready for production            │
│                                      │
└─────────────────────────────────────┘

Production Release

┌─────────────────────────────────────┐
│   PRODUCTION RELEASE WORKFLOW        │
├─────────────────────────────────────┤
│                                      │
│  1. *version bump                   │
│  2. *changelog update               │
│  3. Run pre-release checklist       │
│  4. *build-production               │
│  5. *testflight (iOS)               │
│  6. *playstore internal (Android)   │
│  7. Internal testing (1-2 days)     │
│  8. External beta (optional)        │
│  9. Submit to stores                │
│ 10. Monitor reviews & crashes       │
│                                      │
└─────────────────────────────────────┘

---

🔗 Integration with Other Modules

With GDD (Game Day DJ) Module

// Use both modules together
/gdd     // Music creation
/release // App deployment

// Example workflow:
1. Create songs with GDD module
2. Add to Game Day App
3. Test with Release Manager
4. Deploy to TestFlight

---

📚 Documentation

EAS Build Profiles

From eas.json:

{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {
      "autoIncrement": true
    }
  }
}

Version Management

Semantic Versioning:

MAJOR.MINOR.PATCH

1.0.0 → Initial release
1.1.0 → New features
1.1.1 → Bug fixes
2.0.0 → Breaking changes

Build Numbers:

• iOS: Auto-increments on each build
• Android: versionCode (integer)

---

🎯 Best Practices

Before Every Release

1. ✅ Test on real devices (iOS & Android)
2. ✅ Run all tests
3. ✅ Check for console errors
4. ✅ Verify assets loading
5. ✅ Update version & changelog
6. ✅ Review release notes

Testing Strategy

Local Testing:

• Expo Go (quick iteration)
• Development builds (full features)

Preview Builds:

• Internal team testing
• Multiple devices/OS versions
• Performance testing

Production Testing:

• TestFlight (iOS internal testers)
• Play Console internal track
• Real-world usage scenarios

Release Cadence

Recommended:

• Major: Every 3-6 months
• Minor: Every 2-4 weeks
• Patch: As needed for critical bugs

---

🐛 Troubleshooting

Build Fails

# Clear EAS cache
eas build:clear

# Regenerate credentials
eas credentials

Device Not Detected

iOS:

# Check connection
xcrun xctrace list devices

# Trust computer on device
# Enable Developer Mode (iOS 16+)

Android:

# Check connection
adb devices

# Enable USB debugging
# Enable File Transfer mode

TestFlight Issues

• Check Apple Developer account status
• Verify export compliance settings
• Ensure all required screenshots uploaded
• Review rejection reasons carefully

---

📖 Resources

Official Documentation

• Expo Documentation
• EAS Build
• EAS Submit
• TestFlight
• Google Play Console

Useful Commands

# EAS
eas login
eas build:configure
eas build:list
eas submit

# Expo
npx expo start
npx expo run:ios
npx expo run:android
npx expo prebuild

# Debugging
npx expo doctor
npx react-native doctor

---

🤝 Contributing

This module is part of the BMAD™ ecosystem. Contributions welcome!

1. Fork the repository
2. Create feature branch
3. Add your agent/task
4. Submit pull request

---

📄 License

MIT

---

🙏 Credits

Powered by BMAD™ Core

Built with:

• React Native
• Expo
• EAS (Expo Application Services)
• TypeScript

---

📞 Support

Issues? Questions?

• GitHub Issues
• Discord Community
• Documentation

---

🔄 Version History

v1.0.0 (2024-11-12)

• Initial release
• Release Manager agent
• EAS build workflows
• TestFlight deployment
• Pre-release checklists

---

Happy Building! 🚀📱