Upgrade from Stitch to Realm - Web SDK

Atlas Device SDKs are deprecated. Refer to the deprecation page for details.

Overview

If you have an existing app built with the Stitch SDK, you should migrate your app to use the new Realm SDK. While much of the application logic and flow of information hasn't changed, there are a few changes to how the new SDK connects to the Atlas App Services backend.

Note

This page presents how to migrate from the MongoDB Stitch Browser SDK to the Realm Web SDK.

If you are looking to use the Realm JS SDK to build Node.js applications, check out the Upgrade from Stitch to Realm Node page. If you are looking to develop React Native apps, consider our Upgrade from Stitch to Realm for React Native page.

Changes

What's Changed?	Solution
The backend app connections previously accessed via StitchAppClient are now available through Realm.App. Use the `Realm.App` class to access authentication functionality such as logging in and getting the current user.	Migrate all occurrences of `StitchAppClient` to `Realm.App`.
StitchUser was previously the interface to access application users, but now it is Realm.User.	Migrate all occurrences of `StitchUser` to `Realm.User`.
The login API has changed from stitchAppClient.auth.loginWithCredential() to Realm.App.logIn()	Rewrite all authentication logic to use the new login API.
The API to log users out has changed from stitchAppClient.auth.logout() to Realm.User.logOut().	Rewrite the application logic to log out using the `Realm.User` object's `logOut()` method.
The Stitch SDK required developers to import authentication credentials from the `mongodb-stitch-browser-sdk`. The Realm SDK has a class, Realm.Credentials, that creates credentials for each authentication provider.	Replace imports of authentication credentials with method calls for each respective authentication provider through the `Realm.Credentials` class.
The API to call a Realm function has changed from stitchAppClient.callFunction() to app.currentUser.functions.<MyFunction>().	Replace server function calls with the new API method, `app.currentUser.functions.<MyFunction>()`
The interface to the MongoDB Data Access API, containing objects like MongoDatabase, and MongoCollection, has changed. Through Stitch, passing the RemoteMongoClient.Factory and the string "mongodb-atlas" to StitchAppClient.getServiceClient() creates a remote Mongodb client. The Realm JS SDK creates a remote MongoDB client through the Realm.User.mongoClient method on the user object.	Replace all `mongoClient` instantiations with `Realm.User.mongoClient`.
The Realm SDKs do not provide an interface for calling Services (like the Twilio and AWS services).	Convert references to Third Party Services (AWS or Twilio) in your Stitch Application to Realm functions in your Realm application using the corresponding npm packages. For more information, see Add External Dependencies.

Welcome to the Atlas Device SDK Docs