Overview
Blueprint
A public iOS architecture study project. Notes in the open, not a universal reference.
What this is
Blueprint is a public iOS architecture study project. Code and notes written while learning, not a shipped product or a copy-paste template.
The repo holds Discover (SwiftUI app) and this site (Markdown → Saga → static HTML).
Adapted from Native Birds by Sebastian Panesso.
Getting started
Requirements: Xcode 16+, iOS 17+ simulator, free Geoapify API key.
git clone https://github.com/luizmellodev/Blueprint.git
cd Blueprint
cp Config.xcconfig.sample Config.xcconfig
Set your key in Config.xcconfig (gitignored). Open blueprint.xcodeproj, pick a simulator, ⌘R.
Discover
Discover is the SwiftUI example app: nearby places via Geoapify, with a Discover tab (POI list, city search, pagination), a Favorites tab (SwiftData), and a shared Detail screen.
Architecture
Discover follows Clean Architecture. The pages below describe how I built it in this repo, not how every app should be built.
See Architecture Overview first.
| Topic | Page |
|---|---|
| MVVM on each screen | MVVM |
| Entities & Use Cases | Domain |
| Repositories vs Services | Repositories & Services |
| HTTP & DTOs | Networking |
| Favorites on disk | SwiftData |
| DIContainer & factories | Dependency Injection |
| AppRoute & stacks | Navigation |
| Swift Packages | Modularization |
| Launch to first screen (step-by-step) | App Flow |
Roadmap
Chapters v0.1–v0.12 shipped (setup through docs site). Planned: deep links, MapKit, Remote Config, DocC, pt-BR.