Petulia-Open

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 13 Open GitHub ↗

SwiftUI project consuming a RESTful API

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="./Images/petulia-icon-128.png" width="60" align="right"/>
<h1>Petulia - Pet Adoption iOS App</h1>

<p align="left"> 
<a href="https://swift.org">
<img src="https://img.shields.io/badge/Swift-5.1-orange" alt="Swift Version 5.1" /></a>
<a href="https://developer.apple.com/ios/">
<img src="https://img.shields.io/badge/iOS-14.0%2B-success" alt="iOS Version 14.0"/></a>
<a href="https://developer.apple.com/xcode/swiftui/">
<img src="https://img.shields.io/badge/SwiftUI-2.0-ff69b4" alt="SwiftUI 2.0" /></a>
<a href="https://twitter.com/EsMoscu">
<img src="https://img.shields.io/badge/follow-%40esmoscu-blue" alt="Twitter" /></a>
</p>

## About The Project
<p align="center">
<img src="./Images/petulia-showcase-tinified 1.png" height="500"/>
<img src="./Images/petulia-showcase-tinified 2.png" height="500"/>
<img src="./Images/petulia-showcase-tinified 3.png" height="500"/>
<img src="./Images/petulia-showcase-tinified 4.png" height="500"/>
</p>

This is the source code for **Petulia**, my deep dive into SwiftUI. It is a native iOS app that helps you find shelter pets across the US. It consumes live data from the Petfinder's RESTful API and display results to the user in a modern and nice looking UI.

On the technical site I can highlight that it is reactive, fast, has nice animations, takes avantage of caching and it's a good iOS citizen.

## Built With

* [SwiftUI](https://developer.apple.com/xcode/swiftui/)
* [Combine](https://developer.apple.com/documentation/combine)
* [Swift Package Manager](https://github.com/apple/swift-package-manager)
* [SDWebImageSwiftUI](https://github.com/SDWebImage/SDWebImageSwiftUI)
* [Petfinder API](https://www.petfinder.com/developers/v2/docs/)

## Installation
Petulia is available on the [App Store](https://apps.apple.com/us/app/petulia-adorable-shelter-pets/id1552360947)

Follow this steps to get a local copy up and running:
1. Clone the repo
2. Get your credentials from [Petfinder](https://www.petfinder.com/developers/v2/docs/#using-the-api)
3. Locate Petfinder-Info-Template.plist and rename it to Petfinder-Info.plist
4. Add your API Key and Secret and save

## Contribuiting
This is an open source project, feel free to fork and open a pull request.

### TO-DO:

- [x] Fix typos
- [ ] Add more filters
- [ ] Add more sorting options
- [ ] Add unit test

## Gift to shelters and rescue organizations
Reach out if you need to connect your backend and rebrand this app for your shelter. I will happily assit you, as much as I can, free of charge.

## Special Thanks

Special thanks to [Victoria](https://twitter.com/VicDevPiano), [Tom](https://twitter.com/BEstelrich), [Alberto](https://twitter.com/AlbertoTalavan), [Jeff](https://twitter.com/jefframes), [Ray](https://twitter.com/RayFromVA) and all the awesome people at the [RW Bootcamp](https://www.raywenderlich.com/13699056-meet-the-2020-graduates-of-our-ios-android-bootcamps).

## Contact
* [Follow Me On Twitter](https://twitter.com/EsMoscu)
* [Available For Work On My Site](https://www.seadeveloper.com)

<p align="left">
<a href="https://twitter.com/EsMoscu">
<img src="https://img.shields.io/badge/-Twitter-%231DA1F2" alt="Twitter" /></a> 
<a href="https://www.instagram.com/ispanskiy/">
<img src="https://img.shields.io/badge/-Instagram-%23eb13a5" alt="Instagram" /></a>
<a href="https://www.linkedin.com/in/johandre">
<img src="https://img.shields.io/badge/-LinkedIn-%233781da" alt="LinkedIn"/></a>
</p>

## License

Published under the [Apache License 2.0](https://github.com/bigimot22/Petulia-Open/blob/main/LICENSE).
You are free to use this project to learn or build your own, just don't republish as is as your own.
<br />
<br />

Petulia-Open

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README