## 1. Project Overview & Quickstart (mozilla-mobile/firefox-ios)

# Firefox for iOS and Focus iOS

Download [Firefox iOS](https://apps.apple.com/app/firefox-web-browser/id989804926) and [Focus iOS](https://itunes.apple.com/app/id1055677337) on the App Store.



| **Firefox iOS** |  |  |  |
| --- | --- | --- | --- |
| **Focus iOS** |  |  |  |



## Building the code

This is a monolithic-repository, containing both the Firefox and Focus iOS projects.

As this is an iOS project, it is required to have Xcode on your system, and you should check that `xcode-select -p` points to `/Applications/Xcode.app/Contents/Developer` (or however you've named your `Xcode.app`).

### Automatic Installation (Recommended)
Steps: [Automated Project Setup with FXIOS](https://github.com/mozilla-mobile/firefox-ios/wiki/Automated-Project-Setup-with-FXIOS)

### Manual Installation

1. Clone the repo locally
1. For their related build instructions, please follow the respective project readmes:

- [Firefox for iOS](./firefox-ios/README.md)
- [Focus iOS](./focus-ios/README.md)

## Getting involved

We encourage you to participate in those open source projects. We love Pull Requests, Issue Reports, Feature Requests or any kind of positive contribution. Please read the [Mozilla Community Participation Guidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/) and our [Contributing guidelines](https://github.com/mozilla-mobile/firefox-ios/blob/main/CONTRIBUTING.md) first.

- You can [file a new issue](https://github.com/mozilla-mobile/firefox-ios/issues/new/choose) or research [existing bugs](https://github.com/mozilla-mobile/firefox-ios/issues)

If more information is required or you have any questions then we suggest reaching out to us via:

- Chat on Element channel [#fx-ios](https://chat.mozilla.org/#/room/#fx-ios:mozilla.org) and [#focus-ios](https://chat.mozilla.org/#/room/#focus-ios:mozilla.org) for general discussion, or write DMs to specific teammates for questions.
- Open a [ticket](https://github.com/mozilla-mobile/firefox-ios/issues/new?template=BLANK_ISSUE) with your question.

Want to contribute on the codebase but don't know where to start? Here is a list of [issues that are contributor friendly](https://github.com/mozilla-mobile/firefox-ios/labels/Contributor%20OK), but make sure to read the [Contributing guidelines](https://github.com/mozilla-mobile/firefox-ios/blob/main/CONTRIBUTING.md) first.

## License

    This Source Code Form is subject to the terms of the Mozilla Public
    License, v. 2.0. If a copy of the MPL was not distributed with this
    file, You can obtain one at https://mozilla.org/MPL/2.0/

## 2. Official Technical Reference & Guides (mozilla-mobile/mozilla-mobile.github.io)

# mozilla-mobile.github.io
##Mozilla Mobile Blog

The [Mozilla Mobile Blog][blog-link] runs on [Github Pages][github-pages] with [Jekyll][jekyll].

## Submit a new blog post

* Clone the repo: `git clone https://github.com/mozilla-mobile/mozilla-mobile.github.io`
* `cd mozilla-mobile-github.io`
* Create a new file in `./_posts` with a name that matches the format `YYYY-MM-DD-post-name.markdown`
* Use markdown to write your blog post
* Save images in `./images` and link to them in your post using `[image description]({{site_url}}/images/img.jpg)`
* Commit your new file(s) 
* Push to master
* Your blog post is published!

N.B - only members of the mozilla-mobile team can publish posts

You can read more about how to write posts for Jekyll sites at their [website][jekyll-posts].

## Run the site locally

* Setup RubyGem environment if you do not already have one
* `gem install jekyll bundler`
* Clone the repo: `git clone https://github.com/mozilla-mobile/mozilla-mobile.github.io`
* `cd mozilla-mobile-github.io`
* Install the correct version of Jekyll, the theme and github pages: `bundle update`
* Run the site server: `bundle exec jekyll serve`
* Now browse to `http://localhost:4000`


The site is setup to autoload changes to all files except configuration changes found in `_config.yml`, so there should be no need to do anything but refresh the site to see your changes.




[blog-link]: https://mozilla-mobile.github.io
[github-pages]: https://pages.github.com/
[jekyll]: https://jekyllrb.com/docs/home/
[jekyll-posts]: https://jekyllrb.com/docs/posts/