Skip to content

bsimmons01/Embiggens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The Embiggens Project App Icon

The Embiggens Project

"A noble spirit embiggens the smallest API."

🍩 The Embiggens Project is a SwiftUI-based project that showcases The Simpsons API that runs on your iOS device.

It's a personal fan project built for fun and learning — exploring Springfield through characters, episodes, locations, and more served fresh in JSON form.


🧩 Features

  • Browse famous Simpsons characters, episodes and locations
  • Search or filter through Springfield's characters, episodes, and locations
  • Mark and revisit your favorite characters, episodes, and locations
  • Explore API endpoints interactively
  • Local disk caching implemented for offline viewing
  • Built entirely with SwiftUI and modern async/await networking
  • 100% fan-made, non-commercial project

⚙️ Tech Stack

  • SwiftUI
  • Async/Await for networking
  • Codable for model decoding
  • MVVM architecture
  • GRDB - for SQLite database
  • Self-made local disk caching
  • The Simpsons API as the data source

🚀 Getting Started

  1. Clone the repository
  2. Open Embiggens.xcodeproj in Xcode
  3. Run the app on iOS 17+ simulator

🏛️ Credits

All character data and quotes are provided by The Simpsons API.
This project is not affiliated with or endorsed by The Simpsons, 20th Television, or The Walt Disney Company.

All code written by Brian Simmons, unless otherwise notated, and released under the MIT License. Attribution is required.

This project uses data from The Simpsons Wiki under the Creative Commons Attribution-ShareAlike License (CC BY-SA).

The Simpsons API - RESTful API for The Simpsons universe

SwiftUI CachedAsyncImage - AsyncImage, but with cache capabilities

GRDB - A toolkit for SQLite databases

Stretchy Header (Natalia Panferova)

SwiftUI Popup (Sonya Hew)


📸 Screenshots

Character List Screenshot Character Detail Screenshot Episode List Screenshot Episode Detail Screenshot Location List Screenshot


🧑🏻‍💻 Apps by Brian:

Heard It All App Icon Heard It All - Relive every Billboard Hot 100 #1
What Year Was It? App Icon What Year Was It? - Challenge your memory across history

🧠 Why I Built This

I created The Embiggens Project to explore API integration, caching, and SwiftUI architecture in a playful way.
It's both a learning exercise and a tribute to my favorite show.


💬 About

Created by Brian Simmons
centrasoft.com