Home

Overview

Welcome to the Firefox iOS Wiki! This space is for contributors and maintainers to find technical documentation, development guides, and project resources.

🚀 Getting Started

• Build Instructions
• Contribution Guidelines
• Pull Requests
• Naming PRs

🏗 Architecture

• Application Code Overview
• Application Features Overview
• UI Component Library
• Navigation & Coordinators
• Application Services dependency for Developers

Redux

• Redux
• How to implement
• Guidelines + FAQs

🔧 Development

This section outlines day-to-day development practices — coding guidelines, testing, debugging, and CI tools — to help contributors write consistent, reliable, and maintainable code.

• Code Style
• How to use SwiftUI
• How to use Swift Concurrency
• A Brief Overview of Accessibility
• Theming System and Themeable Protocol

Localization

• How to add and modify Strings
• Import and Export with Localization Tools

Logging

• Logging Strategy
• How to get your device logs
• How to get your device database

Telemetry

• Adding Glean Telemetry Events and Metrics
• Testing Glean

Nimbus

• What's a Nimbus
• Nimbus Features
• Feature Flags

Webviews

• How to work on the WebEngine
• How to trigger WKUIDelegate methods
• Run local server to test websites locally
• WKWebView navigation and security considerations

Feature Overviews

The documentation found here is best thought of as an informative mental map of the feature discussed, rather than a complete breakdown of the code; for that, you should dig into the code itself. However, these documents will allow you to understand the ideas and intentions behind how some features were designed, and how to use them easily.

• Contextual Feature Recommender
• Enhanced Tracking Protection
• Search Engines
• Top Sites/Shortcuts
• Sponsored tiles
• Wallpapers
• Notification Service

Technical topics

This section covers specialized technical guides on frameworks, workflows, and patterns in Firefox iOS — from BrowserKit and Window Management to benchmarking and NotificationCenter usage.

• Working with BrowserKit
• Feature Branch Workflow
• Event Queue
• Window Management
• When to use extensions
• Simulating Default Browser Behavior in Debug Mode
• Code Benchmarking
• Notifiable Protocol

📦 Releases

• Release checklist
• Bitrise overview
• Retry Bitrise Pipeline
• Release & Nightly CI workflows
• Health Monitoring
• Requesting an uplift to a release branch

CI system - Bitrise

• Bitrise General Overview
• Bitrise Builds & Pipelines - How to Rebuild

Crash Reporting

• Sentry

🧪 Testing

Unit tests

• Why and how to write Unit tests
• Unit Test Guidelines
• Feature Flag Unit Testing
• Mocking Redux Middlewares
• Telemetry Unit Testing

UI tests

• Writing your first XCUI test
• Screenshot Tests
• FxScreenGraph and XCUITest
• Sync Integration Tests
• Automated UI Testing
• Performance Tests

Other

• QA Testing Process
• Firefox iOS Test Types
• Manual testing