Step 1: Install the GitHub Mobile App
Download and install GitHub’s official mobile application on your device.
- Open Google Play Store (Android) or App Store (iOS).
- Search for “GitHub”.
- Tap “Install” (Android) or “Get” (iOS).
- Wait for installation to complete.
Step 2: Sign In or Sign Up
Launch the app and authenticate:
- If you already have an account, tap “Sign in” and enter your GitHub username/email and password.
- Optionally enable two-factor authentication (2FA) by following prompts.
- If new to GitHub, tap “Create an account” and follow the on-screen registration steps.
Step 3: Understand the Main Navigation
Familiarize yourself with the bottom navigation bar:
- Home – Activity feed (recent events on watched repos and people).
- Repositories – Browse your own and starred repositories.
- Pull Requests – View open pull requests assigned to you or created by you.
- Notifications – See @mentions, reviews, issues and PR updates.
- Profile – Access your contributions, starred repos, settings and sign-out.
Step 4: Browse and Search Repositories
- Tap the Repositories icon.
- Choose between Your repositories, Starred, and Organizations.
- Use the search bar at the top to type repository names or keywords.
- Select any repo to view its README, code files, issues, and pull requests.
Step 5: View and Read Files
- Within a repository, tap on the Code tab.
- Navigate folders by tapping folder icons.
- Tap a file (e.g.,
README.md
) to view its contents.
- Scroll to read, and use pinch-to-zoom for better readability.
Step 6: Star and Unstar a Repository
- On any repository page, tap the ⭐︎ (star) icon in the top toolbar.
- Tap again to unstar.
- Starred repos show up under your “Starred” list for easy access.
Step 7: Create and Manage Issues
- Open a repository and tap the Issues tab.
- Tap the “+” button to create a new issue.
- Enter a concise Title and detailed Description.
- Optionally add labels, assignees, and milestones.
- Tap “Submit” to open the issue.
- To comment on existing issues, scroll to the bottom, type your comment, and tap “Comment.”
Step 8: Create a Pull Request
- Navigate to the Pull Requests tab in a repository.
- Tap the “+” button to start a new pull request.
- Select the base branch (e.g.,
main
) and your compare branch.
- Review the diff to ensure your changes are correct.
- Enter a descriptive Title and detailed Description.
- Tap “Create Pull Request.”
Step 9: Review and Merge a Pull Request
- Open a pull request from the list.
- Scroll through the Files changed tab to review code.
- Tap the “+” next to any line to add an inline comment.
- Return to the Conversation tab to see all comments.
- When ready, tap “Merge” and choose Merge pull request or other merge method.
- Confirm by tapping “Confirm merge.”
Step 10: Edit Files Directly on Mobile
- Open a file in the Code tab.
- Tap the pencil ✏︎ icon in the top toolbar.
- Make your edits using the on-screen keyboard.
- Scroll down, add a commit message and optional description.
- Choose to commit directly to the branch or create a new branch and pull request.
- Tap “Commit changes.”
Step 11: Manage Notifications
- Tap the Notifications icon in the bottom bar.
- Swipe left on any notification to Mark as read or Delete.
- Tap a notification to navigate directly to the issue, PR, or mention.
- Use the filter icon to view Unread, Mentions, or Participating.
Step 12: View and Edit Your Profile
- Tap the Profile icon on the bottom right.
- View your contributions calendar, pinned repositories, and activity.
- Tap the gear ⚙︎ icon to access Settings:
- Enable or disable notifications.
- Manage accounts and sign in to additional GitHub Enterprise servers.
- Configure appearance (Dark/Light mode).
- Tap “Sign out” to log out of your account.
Step 13: Advanced Tips
- Use “Share” from a repo to copy its URL or open it externally.
- Long-press a file name in the code view to open context menu (e.g., copy path).
- Shake your device (iOS only) to report an issue with the app to GitHub.
- Enable “Pull to refresh” on lists in case of stale data.
Conclusion
You now know how to install, navigate, and perform key workflows—browsing code, creating issues and pull requests, reviewing changes, editing files, and managing notifications—all from your mobile device using the GitHub mobile app. Happy coding on the go!