qttoan-khtn / Papr

:octocat: An Unsplash app for iOS.

🌁 Papr

Papr is an unofficial Unsplash app for iOS.

🏃‍♂️ Getting Started

1. Clone the repository.
2. Run pod install to install dependencies.

⚙️ Setup

To be able to log in during development, you'll need a Client ID and Client Secret.

To get these, register a new OAuth application on Unsplash.

Make sure the Authorization callback URL is set to papr://unsplash. The others can be filled in as you wish.

To add the Client ID and Client Secret to the App, follow these steps:

1. In Xcode, go to Product> Scheme > Manage Schemes...
2. Select Papr and click Edit...
3. Go to Run > Arguments
4. Add your Client ID (UNSPLASH_CLIENT_ID as key) and Client Secret (UNSPLASH_CLIENT_SECRET) to the Environment Variables.

🎉 Why am I building this?

1. Pushing RxSwift to its limits. 🔥
2. MVVM + Coordinator
3. Using Codable
4. Using TinyNetworking (lightweight network library)
5. Exploring Unsplash and its API
6. Using as little dependecies as possible.
7. Fun thing! 🤙

🧘‍♂️ Current state

1. Login with Unsplash
2. Explore New/Curated photos
3. Photo details
4. Like/Unlike photos

🧗‍♂️ ToDos

1. Download photos.
2. Search photos/users/collections.
3. User profile.
4. Add/edit/remove photos to a collection.
5. Write tests.
6. ... more

❤️ Contributing

I intend for this project to be more as an educational resource, learn by open sourcing.

I very open for feedback and contribution. 🤙