1.68 KB
Newer Older
Aral Balkan's avatar
Aral Balkan committed
# Better for iOS and macOS
2 3 4 5 6 7 8

Better protects you from unethical web sites. It makes your web experience safer, lighter, and faster.

Better enforces the [Ethical Design Manifesto]( It helps the Web respect human rights, effort, and experience.

Better is curated by, a social enterprise that defends human rights. It’s free, open, and transparent.

Aral Balkan's avatar
Aral Balkan committed
## I’m not a developer, I just want to experience a Better web.
10 11 12

Get Better from the App Store.

13 14
## How can I support Better?

Aral Balkan's avatar
Aral Balkan committed
Buying Better on the App Store is one way to support us. If you want to help with the ongoing costs of developing and maintaining Better, you can [donate to]( or, even better, [become a patron]( by setting up a recurring donation.

17 18 19 20 21 22 23 24 25 26
## I’m a developer, let me in!

### Installation

On a Mac with Xcode and Git installed:

1. `mkdir better && cd better`
2. `git clone`
3. `cd app && ./install`

Aral Balkan's avatar
Aral Balkan committed
That will install all the necessary dependencies.
28 29 30

Specifically, it will install [Better Builder](, set up a fully offline local development environment for you, and install the framework dependencies of the iOS app.

31 32
Note: The master branch of Better is now written in Swift 4 and support iOS 11. For the older, Swift 3, version, please see the Swift 3 branch (depracated).

### Usage

Aral Balkan's avatar
Aral Balkan committed
35 36 37
38 39 40 41 42 43

This will start the Better Builder environment and open up the Xcode Workspace for the iOS app.

You can then build for the iPhone Simulator and test locally.

See the [Better Builder]( project for more information on the development process.