How izaanshahid/bmi-calculator works
Project Type and Purpose
• Type: Native iOS mobile application
• Purpose: A simple multi-screen Body Mass Index calculator built to teach MVC, Optionals, and Classes vs. Structs
File Structure
• Top-level folders:
– BMI Calculator: contains all Swift code, assets, storyboards
– Documentation: static images
– Project config (.xcodeproj, Info.plist, SceneDelegate.swift, AppDelegate.swift)
• MVC pattern:
– Models: CalculateBrain.swift (contains BMI calculation logic, BMI struct)
– Views: Main.storyboard, LaunchScreen.storyboard, Assets.xcassets
– Controllers: CalculateViewController.swift, ResultViewController.swift
• No external services, network calls, or databases
Key Insights from README
• Optionals, MVC, Classes vs. Structs
• Two screens: “Calculate” and “Result”
• No persistent storage or remote APIs
Main Components
A. iOS App Shell
– AppDelegate & SceneDelegate (app lifecycle, window setup)
B. View Layer
– Storyboard Scenes:
• Calculate Screen (UITextField for weight & height, UIButton “Calculate”)
• Result Screen (UILabel for BMI value & advice)
– Assets (AppIcon, background images)
C. Controller Layer
– CalculateViewController
• Handles user input, triggers model calculation, performs segue to ResultViewController
– ResultViewController
• Receives BMI data, updates UI
D. Model Layer
– CalculateBrain class
• Contains computeBMI(height, weight) → BMI struct
– BMI struct
Relationships & Data Flows
1. App launches → SceneDelegate sets root UINavigationController from Main.storyboard
2. UINavigationController shows CalculateViewController
3. User enters inputs → CalculateViewController reads UITextFields
4. CalculateViewController calls CalculateBrain.calculateBMI(…)
6. CalculateViewController performs segue → passes BMI to ResultViewController
Architectural Patterns & Principles
• MVC:
– Model (CalculateBrain + BMI struct) is completely decoupled from ViewControllers
– ViewControllers mediate between Views (storyboards) and Model
• Single Responsibility: each ViewController manages only its own screen
• Dependency Injection: BMI data is injected into the ResultViewController via segue