Design+Code logo

Quick links

Suggested search

FirestoreManager class

Create a FirestoreManager class. Learn more about it in the Read from Firestore section of this SwiftUI Handbook.

// FirestoreManager.swift

import Foundation
import Firebase

class FirestoreManager: ObservableObject {

}

Create a document

Let's say we want to create a new restaurant called Poutine Fiesta in our database. We will need to create a new document.

To create a document in Firestore, simply follow the code example below.

func createRestaurant(restaurantName: String) {
    let db = Firestore.firestore()

    let docRef = db.collection("Restaurants").document(restaurantName)

    docRef.setData(["name": restaurantName]) { error in
        if let error = error {
            print("Error writing document: \(error)")
        } else {
            print("Document successfully written!")
        }
    }
}

In this function, we are passing a restaurantName as an argument. Inside of the function, we are creating a database reference with Firestore.firestore(). Next, we specify our docRef. In my case, I want to save the new document under the Restaurants collection.

If you want to add multiple fields to the document, I suggest you create a dictionary variable (as [String: Any]) with all your data first, then pass it in the .setData method.

// Create your docData variable first
let docData: [String: Any] = [
    "name": "PoutineFiesta",
    "address": "1234 Restaurant St",
    "dateAdded": Timestamp(date: Date()),
]

// Create the document in Firestore
func createRestaurant() {
        let db = Firestore.firestore()

        let docRef = db.collection("Restaurants").document("PoutineFiesta")

				docRef.setData(docData) { error in
				    if let error = error {
				        print("Error writing document: \(error)")
				    } else {
				        print("Document successfully written!")
				    }
				}
}

Note that when using the .setData(), it will overwrite the existing data in the document, unless you set the merge option to true (see below).

Update a document

Let's say that Poutine Fiesta has moved to a new address and we want to update it.

To update a document in Firestore, you can use the .updateData() method.

func updateRestaurant(restaurantName: String, restaurantAddress: String) {
    let db = Firestore.firestore()

    let docRef = db.collection("Restaurants").document(restaurantName)

    docRef.updateData(["address": restaurantAddress]) { error in
        if let error = error {
            print("Error updating document: \(error)")
        } else {
            print("Document successfully updated!")
        }
    }
}

However, I prefer to use the .setData() method and set the merge option to true, as it will update the document, and also create it if it doesn't exist. The downside with .updateData() is that it will run into an error if the document doesn't exist.

func updateRestaurant(restaurantName: String, restaurantAddress: String) {
        let db = Firestore.firestore()

        let docRef = db.collection("Restaurants").document(restaurantName)

				// Don't forget the **merge: true** before closing the parentheses!
				docRef.setData(["address": restaurantAddress], merge: true) ****{ error in
				    if let error = error {
				        print("Error writing document: \(error)")
				    } else {
				        print("Document successfully merged!")
				    }
				}
}

And voilà! Now you can create new documents and update them in Firestore!

You can read more about adding and updating data in Firestore's documentation.

Update Firestore permission rules

Once you're ready to release your app, remember to update your Firestore rules to protect your database and not allow anyone to read and write your database.

Navigate to Cloud Firestore and click on the Rules tab. There, you'll see the rules that are currently applied to your database.

We added the feature to write to our database, so we will need to add the write keyword.

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{Restaurants=**} {
      allow read, write: if true;
    }
  }
}

You can read more about Cloud Firestore Rules here.

Learn with videos and source files. Available to Pro subscribers only.

Purchase includes access to 50+ courses, 320+ premium tutorials, 300+ hours of videos, source files and certificates.

BACK TO

Read from Firestore

READ NEXT

Join an Array of Strings

Templates and source code

Download source files

Download the videos and assets to refer and learn offline without interuption.

check

Design template

check

Source code for all sections

check

Video files, ePub and subtitles

Videos

Assets

ePub

Subtitles

1

Firebase Auth

How to install Firebase authentification to your Xcode project

8:18

2

Read from Firestore

Install Cloud Firestore in your application to fetch and read data from a collection

8:01

3

Write to Firestore

Save the data users input in your application in a Firestore collection

5:35

4

Join an Array of Strings

Turn your array into a serialized String

3:33

5

Data from JSON

Load data from a JSON file into your SwiftUI application

5:08

6

HTTP Request

Create an HTTP Get Request to fetch data from an API

6:31

7

WKWebView

Integrate an HTML page into your SwiftUI application using WKWebView and by converting Markdown into HTML

5:25

8

Code Highlighting in a WebView

Use Highlight.js to convert your code blocks into beautiful highlighted code in a WebView

5:11

9

Test for Production in the Simulator

Build your app on Release scheme to test for production

1:43

10

Debug Performance in a WebView

Enable Safari's WebInspector to debug the performance of a WebView in your application

1:57

11

Debug a Crash Log

Learn how to debug a crash log from App Store Connect in Xcode

2:22

12

Simulate a Bad Network

Test your SwiftUI application by simulating a bad network connection with Network Link Conditionner

2:11

13

Archive a Build in Xcode

Archive a build for beta testing or to release in the App Store

1:28

14

Apollo GraphQL Part I

Install Apollo GraphQL in your project to fetch data from an API

6:21

15

Apollo GraphQL Part 2

Make a network call to fetch your data and process it into your own data type

6:43

16

Apollo GraphQL Part 3

Display the data fetched with Apollo GraphQL in your View

5:08

17

Configuration Files in Xcode

Create configuration files and add variables depending on the environment - development or production

4:35

18

App Review

Request an app review from your user for the AppStore

5:43

19

ImagePicker

Create an ImagePicker to choose a photo from the library or take a photo from the camera

5:06

20

Compress a UIImage

Compress a UIImage by converting it to JPEG, reducing its size and quality

3:32

21

Firebase Storage

Upload, delete and list files in Firebase Storage

11:11

22

Search Feature

Implement a search feature to filter through your content in your SwiftUI application

9:13

23

Push Notifications Part 1

Set up Firebase Cloud Messaging as a provider server to send push notifications to your users

5:59

24

Push Notifications Part 2

Create an AppDelegate to ask permission to send push notifications using Apple Push Notifications service and Firebase Cloud Messaging

6:30

25

Push Notifications Part 3

Tie everything together and test your push notifications feature in production

6:13

26

Network Connection

Verify the network connection of your user to perform tasks depending on their network's reachability

6:49

27

Download Files Locally Part 1

Download videos and files locally so users can watch them offline

6:05

28

Download Files Locally Part 2

Learn how to use the DownloadManager class in your views for offline video viewing

6:02

29

Offline Data with Realm

Save your SwiftUI data into a Realm so users can access them offline

10:20

30

HTTP Request with Async Await

Create an HTTP get request function using async await

6:11

31

Xcode Cloud

Automate workflows with Xcode Cloud

9:23

32

SceneStorage and TabView

Use @SceneStorage with TabView for better user experience on iPad

3:52

33

Network Connection Observer

Observe the network connection state using NWPathMonitor

4:37

34

Apollo GraphQL Caching

Cache data for offline availability with Apollo GraphQL

9:42

35

Create a model from an API response

Learn how to create a SwiftUI model out of the response body of an API

5:37

36

Multiple type variables in Swift

Make your models conform to the same protocol to create multiple type variables

4:23

37

Parsing Data with SwiftyJSON

Make API calls and easily parse data with this JSON package

9:36

38

ShazamKit

Build a simple Shazam clone and perform music recognition

12:38

39

Firebase Remote Config

Deliver changes to your app on the fly remotely

9:05