Skip to content

feature: Add emulator setup guide to CONTRIBUTING.md (android/ios)#219

Merged
mrspence merged 1 commit into
Whisper-AI-App:mainfrom
RONAK-AI647:RONAL-AI647/Feature---CONTRIBUTING.md-dev-guidance-#122(Android)
Jun 30, 2026
Merged

feature: Add emulator setup guide to CONTRIBUTING.md (android/ios)#219
mrspence merged 1 commit into
Whisper-AI-App:mainfrom
RONAK-AI647:RONAL-AI647/Feature---CONTRIBUTING.md-dev-guidance-#122(Android)

Conversation

@RONAK-AI647

Copy link
Copy Markdown
Contributor

Closes #122

What's changed

Added a new Running on Emulators section to CONTRIBUTING.md covering:

  • Android (standard) — macOS / Linux / Windows native setup via Android Studio
  • Android (WSL2) — step-by-step guide for Windows Subsystem for Linux users, including ANDROID_HOME configuration and common adb ENOENT troubleshooting
  • iOS — macOS only, Xcode setup

Why

The existing CONTRIBUTING.md mentioned emulators in the Requirements section but gave no actual setup guidance. New contributors (especially on WSL2) had no clear path to get the app running locally.

This guide is written from real experience setting up the Android emulator on WSL2 while working on issue #127, so the WSL2 section in particular covers real gotchas that aren't documented elsewhere.

@mrspence

Copy link
Copy Markdown
Member

@RONAK-AI647 This has been a long time coming and appreciate you putting this together!

No edits, looks great (and checks out with how we've approached local emulators on mac) - merging now 👍

@mrspence mrspence merged commit 99fea48 into Whisper-AI-App:main Jun 30, 2026
4 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature - CONTRIBUTING.md dev guidance

2 participants