/Slide-iOS

A beautiful Reddit browser for iOS

Primary LanguageSwiftApache License 2.0Apache-2.0

Slide for Reddit iOS App Store Reddit Discord

Slide is a powerful open-source, ad-free, Swift-based Reddit browser for iOS. Feel free to join us on the official subreddit for discussion or requests!





Getting started

To get started with Slide iOS development, you need to set up CocoaPods integration and open the Coacoapods workspace, not the default xcworkspace. NOTE: You must open the .xcworkspace file instead of the .xcodeproj file for dependencies to load. If you are having issues with Pods or are setting up the Slide repository for the first time, try the steps below.

Below are the steps to getting started:

  1. Clone this repo and open the Terminal
  2. In Terminal, run pod install
  3. Open "Slide for Reddit.xcworkspace" through Finder
  4. Go to the project build settings and change USR_DOMAIN to something else (see below for an alternative).

Make your life easier:

You can automate the process of changing your credentials and USR_DOMAIN, which we recommend. Alter /scripts/install-filter.sh with the information it asks for, then run it (sh ./scripts/install-filter.sh). Once done, you can freely change branches and pull without needing to mess around with your signing info.

If you are having trouble building on XCode 10 or MacOS Mojave

Try running chmod 666 Pods/Realm/include/RLMPlatform.h from Terminal in the project root directory.

If you don't have a paid Apple Developer account and you get warnings about iCloud entitlements

Select "none" for your team, go to the "Capabilities" section of the project build settings, and disable iCloud and IAP support. Then, add yourself back as the team and build!

If you still run into problems, feel free to shoot me a message on Reddit or Discord (above).

What needs to be done

Any issues are fair game, but any issue with the "Help Wanted" or "Enhancement" tags are issues that we would particularly love help with. If you have any questions or want to be pointed in the right direction, feel free to send me a PM on Reddit to /u/ccrama, or join us on Discord!

Issues

In any project, it's likely that a few bugs will slip through the cracks, so it helps greatly if people document any bugs they find to ensure that they get fixed promptly.

You can view a list of known issues and feature requests using the issue tracker. If you don't see your issue (or you aren't sure) feel free to submit it!

Where appropriate, a screenshot works wonders to help us see exactly what the issue is. You can upload screenshots directly using the GitHub issue tracker or by attaching a link (to Imgur, for example); whichever is easier for you.

Code

If you are a developer and wish to contribute to the app, please fork the project and submit a pull request.

If you have any questions, feel free to message me on Discord or drop me a message on Reddit.

Changes

For a detailed look at changes to the app you can view individual commits.

Licensing

Slide is licensed under the Apache 2 License.

If you find Slide's code useful or you use code from this repository, feel free to let me know!