Realm Web Quick Start

Overview

This page shows you how to connect the Realm Web SDK to an Atlas App Services backend, authenticate a user, and work with data. Before you begin, you'll need to create an App for your web app to use.

Install the Web SDK

Import the Web SDK

Near the top of any JavaScript or TypeScript file that uses Realm, add the following import statement:

import * as Realm from "realm-web";

Initialize the App

To use App Services features such as user authentication and functions, you must access your App using your App ID. You can find your App ID in the App Services UI.

// Add your App ID
const app = new Realm.App({ id: APP_ID });

Authenticate a User

When anonymous authentication is enabled, users can log into your app without providing any identifying information:

// Create an anonymous credential
const credentials = Realm.Credentials.anonymous();
// Authenticate the user
const user = await app.logIn(credentials);
// `App.currentUser` updates to match the logged in user
console.assert(user.id === app.currentUser.id);

App Services provides many additional ways to authenticate, register, and link users.

Call a Function

To call a function, use the Realm.User.functions interface to call your serverless functions as if they were regular JavaScript functions defined on the object.

const summed = await user.functions.sum(2, 3);
console.assert(summed === 5);

Use the GraphQL API

To execute CRUD operations and call custom resolvers through the GraphQL API, we recommend that you use a third-party GraphQL library such as Apollo Client. To authenticate your GraphQL request, include a valid user token in the Authorization header of the request.