# ios-oss **Repository Path**: ddusen/ios-oss ## Basic Information - **Project Name**: ios-oss - **Description**: From: https://github.com/kickstarter/ios-oss - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-09-02 - **Last Updated**: 2021-09-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README Kickstarter for iOS [![Circle CI](https://circleci.com/gh/kickstarter/ios-oss.svg?style=svg)](https://circleci.com/gh/kickstarter/ios-oss) [![codecov](https://codecov.io/gh/kickstarter/ios-oss/branch/main/graph/badge.svg)](https://codecov.io/gh/kickstarter/ios-oss) Welcome to Kickstarter’s open source iOS app! Come on in, take your shoes off, stay a while—explore how Kickstarter’s native squad has built and continues to build the app. We’ve also open sourced our [Android app](https://github.com/kickstarter/android-oss), and read more about our journey to open source [here](https://kickstarter.engineering/open-sourcing-our-android-and-ios-apps-6891be909fcd). ## Getting Started 1. Install Xcode. 1. Clone this repository. 1. Run `make bootstrap` to install tools and dependencies. * To provide a mock version that serves up hard-coded data immediately, set `KsApi.Secrets.isOSS` = `true`. ## Some fun things to explore If you’re just looking for a quick glance at a few things we’re particularly proud of, look no further: * The [`Screenshots`](https://github.com/kickstarter/ios-oss/tree/main/Screenshots/_64) directory holds nearly 500 screenshots of various screens in every language, device and edge-case state that we like to make sure stays true. For example, a backer viewing a project in French [here](https://github.com/kickstarter/ios-oss/blob/d33bfbff8dee212eb46328cfcfe64f5aa90afc7b/Screenshots/_64/Kickstarter_Framework_iOSTests.ProjectPamphletContentViewControllerTests/testBacker_LiveProject_lang_fr_device_phone4_7inch%402x.png) , or a creator looking at their dashboard in German and on an iPad [here](https://github.com/kickstarter/ios-oss/blob/64f79ce6a03a8fad9b7024a43c17b4ae5f264d31/Screenshots/_64/Kickstarter_Framework_iOSTests.DashboardViewControllerTests/testView_lang_de_device_pad%402x.png). * [We use view models](https://www.youtube.com/watch?v=EpTlqx6NjYo) as a lightweight way to isolate side effects and embrace a functional core. We write [these](https://github.com/kickstarter/ios-oss/tree/main/Library/ViewModels) as a pure mapping of input signals to output signals, and [test](https://github.com/kickstarter/ios-oss/tree/main/Library/ViewModels) them heavily, including tests for localization, accessibility and event tracking. ## Testing the project - Run all tests from the command line by running `make test-all`. - Run an individual scheme's tests by selecting that scheme in Xcode and hitting CMD+U. ## Documentation While we’re at it, why not share our docs? Check out the [native docs](https://github.com/kickstarter/native-docs) we have written so far for more documentation. ## Dependencies We make heavy use of the following projects, and so it can be helpful to be familiar with them: ### 1st party * [![Circle CI](https://circleci.com/gh/kickstarter/Kickstarter-Prelude.svg?style=svg)](https://circleci.com/gh/kickstarter/Kickstarter-Prelude) [Prelude](https://github.com/kickstarter/Kickstarter-Prelude): Foundation of types and functions we feel are missing from the Swift standard library. * [![Circle CI](https://circleci.com/gh/kickstarter/Kickstarter-ReactiveExtensions.svg?style=svg&)](https://circleci.com/gh/kickstarter/Kickstarter-ReactiveExtensions) [ReactiveExtensions](https://github.com/kickstarter/Kickstarter-ReactiveExtensions): A collection of operators we like to add to ReactiveCocoa. ### 3rd party * [AlamofireImage](https://github.com/Alamofire/AlamofireImage) * [FBSnapshotTestCase](https://github.com/facebook/ios-snapshot-test-case) * [ReactiveSwift](https://github.com/ReactiveCocoa/ReactiveSwift) Notices for 3rd party libraries in this repository are contained in `NOTICE.md`. ## Contributing We intend for this project to be an educational resource: we are excited to share our wins, mistakes, and methodology of iOS development as we work in the open. Our primary focus is to continue improving the app for our users in line with our roadmap. The best way to submit feedback and report bugs is to open a GitHub issue. Please be sure to include your operating system, device, version number, and steps to reproduce reported bugs. Keep in mind that all participants will be expected to follow our code of conduct. ## Code of Conduct We aim to share our knowledge and findings as we work daily to improve our product, for our community, in a safe and open space. We work as we live, as kind and considerate human beings who learn and grow from giving and receiving positive, constructive feedback. We reserve the right to delete or ban any behavior violating this base foundation of respect. ## Find this interesting? We do too, and we’re [hiring](https://www.kickstarter.com/jobs?ref=gh_ios_oss)! ## License ``` Copyright 2021 Kickstarter, PBC. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ```