(Foods App) SwiftUI Multiplatform & Navigation Sample App

Introduction

This repo a 100% SwiftUI app showcasing examples of navigation, Multiplatform support & deep linking using the new NavigationStack & NavigationSplitView API’s based of my course that that showcases everything you need to know about handling navigation in SwiftUI apps.

Everything You Need To Know About Requesting App Reviews Ratings In SwiftUI Copy 8

Requirements

  • Xcode 14.2+
  • Swift 5.7+
  • SwiftUI 4.0+
  • iOS16.1+

Preview

Platform Preview
iPhone
iPad
Mac

Features

  • Simple & Organised Project structure
  • iPhone, iPad & Mac support
  • Handling Sheet presentation using detents
  • Examples of handling navigation using NavigationStack & navigationDestination(for:destination:)
  • Handling navigation programatically by building a RouteManager
  • Custom URL Scheme Integration for deep links
  • How to handle deeplinking in SwiftUI for multiplatform & route to screens
  • Firebase integration using SPM ?Replace GoogleService’s Plist with your own?
  • Push Notification support using FCM (Firebase Cloud Messaging)
  • How to handle push notification deep links
  • Adapative iPad & Mac layout for 2 & 3 column layouts
  • keyboardShortcut(_:) actions to toggle side bar visibility
  • Apple Pencil actions using onHover for animating hover effects for iPad & Mac
  • Unit Tests

Project Installation

  1. Clone the repository using git clone https://github.com/tunds/SwiftUI-Navigation-Multiplatform-Example.git or use Open in Xcode
  2. Open the project in Xcode
  3. Build and run the app on a simulator or device for either iPhone, iPad or MacOS

Deep Links Setup Guide (Custom URL Schemes)

In order get deep links working in the sample project you could either use the default stock app on the device, terminal or a handy tool like RocketSim. You can check out this chapter in my video to learn more about testing deep links on a device here.

Below is a table of all the current deeplinks the application handles routing for and will navigate to.

Name Example Purpose Condition
Invalid Product myfoodapp://product?item=xxxx Handles showing an invalid product screen for when the app can’t find a product with the specified id. For the item key query parameter add in an invalid product id
Open Item myfoodapp://product?item=?_Ice+Cream Handles showing a product that has been defined, in the dummy data model. For the item key query parameter the id is a combination of the title and name, all the valid ids can be found in Food.swift and it’s normally a combination of <emoji>_<title>. Any spaces are replaced with a +.
Promo myfoodapp://promo?discount=0.3&desc=enjoy+this+discount Handles showing a promotion to the user. For the discount key query parameter the value should be a decimal represented in a string representation and the desc key has a value of a string, any space should be replaced with a +
Open App myfoodapp://menu Opens up the app There are no query parameters for this since this just opens up the app using a generic url scheme

Push Notification Setup Guide (FCM)

This project uses FCM for handling push notifications. This project already has Firebase added as a Swift Package. But you will need to replace the GoogleServices plist file with your own if you plan to connect this to your own Firebase project. A guide on this can be seen here.

Once you do this you can then setup your firebase project by uploading either an APNS Key or Certificates. You can learn more about this here.

The code for push notification deep links is reusing code and the same deep links defined in the table in Deep Links Setup Guide (Custom URL Schemes). In order to send a deep link in firebase make sure the key you use is link and you copy one of the deeplinks defined above.

Credits

This demo app was created me tundsdev. And is part of a course which you can view in an playlist on my channel here. This playlist essentially breaks down all the code that exists in this playlist and everything you need to know. I would also highly recommend you check out these videos to learn more about my thought process and reasoning. Below are links to each video in this course which builds up this project.

Credits

Buy Me a Coffee at ko-fi.com

If you’re interested in following me you can find me on:

I also have a Kofi where you can donate and buy me a coffee if you found this useful also.

? License

Copyright © 2023 Tunde Adegoroye

License: MIT

GitHub

View Github