aws-amplify

The Amplify singleton facade provides the v6-compatible, global-state configure() / getConfig() API. It builds a branded, frozen AmplifyContext, publishes it as the global context (so category APIs can be called without an explicit context argument), and dispatches the configure Hub event that side effects such as auth's OAuth listener depend on.

Example 1

import { Amplify } from 'aws-amplify';
import config from './amplifyconfiguration.json';

Amplify.configure(config);

Creates a local, branded AmplifyContext from the given resource configuration.

Unlike Amplify.configure(), the returned context is **not** set as the global context and no Hub events are dispatched. Category APIs that receive this context (as their first positional argument) will use it instead of the global one, enabling per-request context injection in server-side / multi-tenant scenarios.

This is the aws-amplify-level wrapper around `@aws-amplify/core`'s `createAmplifyContext`. The core factory intentionally does **not** inject default Cognito providers (it sits below @aws-amplify/auth in the dependency graph); this wrapper closes that gap by resolving and injecting **factory-style, per-context** Cognito token/credentials providers when the caller does not supply their own. Because each call builds fresh provider instances, contexts created here do **not** share the process-wide singleton providers used by Amplify.configure() — two contexts remain isolated from one another.

Storage behaviour mirrors Amplify.configure(): tokens are persisted to localStorage by default, or to cookies when { ssr: true } is set.

Parameter resourceConfig

Back-end resource configuration (typed config, legacy aws-exports, or Gen2 amplify_outputs).

Parameter libraryOptions

Optional library options (e.g. Auth token/credentials providers, ssr).

Returns

A branded, frozen AmplifyContext.

Example 1

import { createAmplifyContext } from 'aws-amplify';
import outputs from './amplify_outputs.json';

const ctx = createAmplifyContext(outputs);
// Pass ctx explicitly to category APIs:
await signIn(ctx, { username, password });