Skip to content

SithumRaigamage/CatBreedExplorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐱 CatBreedExplorer

A beautiful SwiftUI app to explore cat breeds β€” browse detailed profiles, view photos, and learn fun facts about every breed.


✨ Features

  • 🐾 Breed Directory β€” Browse all cat breeds from The Cat API
  • πŸ“Έ High-quality Photos β€” Beautiful breed imagery loaded async
  • πŸ“– Breed Details β€” Temperament, origin, lifespan, weight, and trait ratings
  • ⭐ Favorites β€” Save your favorite breeds locally
  • πŸ” Search β€” Find any breed by name instantly
  • πŸ—οΈ MVVM Architecture β€” Clean separation of concerns

πŸ—οΈ Architecture

CatBreedExplorer/
β”œβ”€β”€ Model/
β”‚   └── CatModel.swift         # Breed data model
β”œβ”€β”€ View/
β”‚   └── CatUI.swift            # SwiftUI views
β”œβ”€β”€ ViewModel/
β”‚   └── CatViewModel.swift     # Business logic & state
└── Service/
    └── CatService.swift       # The Cat API networking layer

πŸš€ Getting Started

Requirements

  • Xcode 15+
  • iOS 17+ simulator or device
  • Free API key from thecatapi.com

Setup

  1. Clone the repo
  2. Open CatBreedExplorer.xcodeproj in Xcode
  3. Add your API key in CatService.swift
  4. Build & run on simulator or device

🌐 API

This app uses The Cat API β€” a free, public API for cat breed data and images.


πŸ“œ License

MIT Β© Sithum Raigamage

About

🐱 SwiftUI iOS app to explore cat breeds with photos, traits, and favorites. Powered by The Cat API.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages