Name:
interface
Value:
Amplify has re-imagined the way frontend developers build fullstack applications. Develop and deploy without the hassle.

Fullstack TypeScript

Write your app's data model, auth, storage, and functions in TypeScript; Amplify will do the rest.

Built with the AWS CDK

Use any cloud resource your app needs. Never worry about scale.

Back to Gen 1 DocsLearn more about Gen 2
Build a BackendFrontend LibrariesUI LibrariesDevelop with AIHostingReference

Choose your framework/language

Gen1 DocsLegacy
Edit on GitHub

Page updated Apr 23, 2026

Need to configure your backend?See Build a Backend →

Connect to existing AWS resources

Amplify client libraries can be used independently without the Amplify backend workflow. If you've provisioned AWS resources with CDK, Terraform, CloudFormation, or the AWS Console, you can connect Amplify libraries directly to those resources.

This means you can adopt Amplify's client libraries for authentication, data, storage, and more — while keeping full control over your infrastructure.

When to use this approach

  • You already have AWS resources provisioned with CDK, Terraform, or CloudFormation
  • You want to use Amplify client libraries without adopting the Amplify backend (ampx) workflow
  • You need to connect to shared infrastructure managed by a platform team
  • You want programmatic control over configuration for testing or environment switching

How it works

There are two ways to configure Amplify client libraries with your own resources:

Option 1: Manual amplify_outputs.json

Create an amplify_outputs.json file in your app/src/main/res/raw/ directory. See the full specification for all supported fields.

amplify_outputs.json
{
  "version": "1",
  "auth": {
    "aws_region": "us-east-1",
    "user_pool_id": "us-east-1_abc123",
    "user_pool_client_id": "abcdef123456",
    "identity_pool_id": "us-east-1:11111111-2222-3333-4444-555555555555"
  }
}

Then configure Amplify as usual:

Amplify.addPlugin(AWSCognitoAuthPlugin())
Amplify.configure(applicationContext)

Option 2: Programmatic configuration with AmplifyOutputsData

Build the configuration in code without any JSON files:

import com.amplifyframework.core.Amplify
import com.amplifyframework.core.configuration.AmplifyOutputsData
import com.amplifyframework.auth.cognito.AWSCognitoAuthPlugin


val config = AmplifyOutputsData(
    auth = Auth(
        awsRegion = "us-east-1",
        userPoolId = "us-east-1_abc123",
        userPoolClientId = "abcdef123456"
    )
)


Amplify.addPlugin(AWSCognitoAuthPlugin())
Amplify.configure(config, applicationContext)

This approach is ideal for:

  • Unit testing — Configure Amplify without bundling JSON files
  • Environment switching — Build different configurations for dev/staging/prod
  • Dynamic configuration — Fetch configuration from a remote source at runtime

Configure Auth (Amazon Cognito)

Connect to an existing Cognito User Pool and Identity Pool.

val config = AmplifyOutputsData(
    auth = Auth(
        awsRegion = "us-east-1",
        userPoolId = "us-east-1_abc123",
        userPoolClientId = "abcdef123456",
        identityPoolId = "us-east-1:11111111-2222-3333-4444-555555555555",
        passwordPolicy = Auth.PasswordPolicy(
            minLength = 8,
            requireNumbers = true,
            requireLowercase = true,
            requireUppercase = true,
            requireSymbols = false
        ),
        oauth = Auth.Oauth(
            identityProviders = listOf(
                IdentityProviders.GOOGLE,
                IdentityProviders.SIGN_IN_WITH_APPLE
            ),
            domain = "myapp.auth.us-east-1.amazoncognito.com",
            scopes = listOf("openid", "email", "profile"),
            redirectSignInUri = listOf("myapp://callback"),
            redirectSignOutUri = listOf("myapp://signout"),
            responseType = ResponseType.Code
        ),
        standardRequiredAttributes = listOf(
            AmazonCognitoStandardAttributes.EMAIL
        ),
        usernameAttributes = listOf(
            UsernameAttributes.EMAIL
        ),
        userVerificationTypes = listOf(
            VerificationMechanism.EMAIL
        ),
        unauthenticatedIdentitiesEnabled = true,
        mfaConfiguration = MfaConfiguration.OPTIONAL,
        mfaMethods = listOf(
            MfaMethods.SMS,
            MfaMethods.TOTP
        )
    )
)


Amplify.addPlugin(AWSCognitoAuthPlugin())
Amplify.configure(config, applicationContext)

Auth required fields

FieldRequiredDescription
awsRegionYesAWS region (e.g. us-east-1)
userPoolIdYesCognito User Pool ID
userPoolClientIdYesCognito app client ID
identityPoolIdNoCognito Identity Pool ID (needed for guest access and IAM-based auth)
passwordPolicyNoPassword requirements (min length, character types)
oauthNoOAuth/Hosted UI configuration (social sign-in)
mfaConfigurationNoMFA mode: NONE, OPTIONAL, or REQUIRED
mfaMethodsNoMFA types: SMS, TOTP

Configure Data (AWS AppSync)

Connect to an existing AppSync GraphQL API.

val config = AmplifyOutputsData(
    data = Data(
        awsRegion = "us-east-1",
        url = "https://abc123.appsync-api.us-east-1.amazonaws.com/graphql",
        apiKey = "da2-abcdefghijklmno",
        defaultAuthorizationType = AwsAppsyncAuthorizationType.API_KEY,
        authorizationTypes = listOf(
            AwsAppsyncAuthorizationType.API_KEY,
            AwsAppsyncAuthorizationType.AMAZON_COGNITO_USER_POOLS
        )
    )
)


Amplify.addPlugin(AWSApiPlugin())
Amplify.configure(config, applicationContext)

Data required fields

FieldRequiredDescription
awsRegionYesAWS region
urlYesAppSync GraphQL endpoint URL
defaultAuthorizationTypeYesDefault auth mode: API_KEY, AMAZON_COGNITO_USER_POOLS, AWS_IAM, or OPENID_CONNECT
authorizationTypesYesAll supported auth modes
apiKeyNoRequired if using API_KEY auth

Configure Storage (Amazon S3)

Connect to an existing S3 bucket.

val config = AmplifyOutputsData(
    auth = Auth(
        awsRegion = "us-east-1",
        userPoolId = "us-east-1_abc123",
        userPoolClientId = "abcdef123456",
        identityPoolId = "us-east-1:11111111-2222-3333-4444-555555555555"
    ),
    storage = Storage(
        awsRegion = "us-east-1",
        bucketName = "my-app-bucket"
    )
)


Amplify.addPlugin(AWSCognitoAuthPlugin())
Amplify.addPlugin(AWSS3StoragePlugin())
Amplify.configure(config, applicationContext)

Multiple buckets

val config = AmplifyOutputsData(
    storage = Storage(
        awsRegion = "us-east-1",
        bucketName = "primary-bucket",
        buckets = listOf(
            Storage.Bucket(
                name = "media",
                bucketName = "my-media-bucket",
                awsRegion = "us-east-1"
            ),
            Storage.Bucket(
                name = "logs",
                bucketName = "my-logs-bucket",
                awsRegion = "us-west-2"
            )
        )
    )
)

Storage requires Auth (Cognito Identity Pool) for authorization. Always configure Auth alongside Storage.

Storage required fields

FieldRequiredDescription
awsRegionYesAWS region
bucketNameYesDefault S3 bucket name
bucketsNoAdditional named buckets for multi-bucket setups

Configure Analytics (Amazon Pinpoint)

Connect to an existing Pinpoint application.

val config = AmplifyOutputsData(
    analytics = Analytics(
        amazonPinpoint = Analytics.AmazonPinpoint(
            awsRegion = "us-east-1",
            appId = "abc123def456"
        )
    )
)


Amplify.addPlugin(AWSPinpointAnalyticsPlugin())
Amplify.configure(config, applicationContext)

Configure Geo (Amazon Location Service)

Connect to existing Location Service resources.

val config = AmplifyOutputsData(
    geo = Geo(
        awsRegion = "us-east-1",
        maps = Geo.Maps(
            items = mapOf(
                "myMap" to AmazonLocationServiceConfig(
                    style = "VectorEsriStreets"
                )
            ),
            default = "myMap"
        ),
        searchIndices = Geo.SearchIndices(
            items = listOf("myPlaceIndex"),
            default = "myPlaceIndex"
        ),
        geofenceCollections = Geo.GeofenceCollections(
            items = listOf("myGeofenceCollection"),
            default = "myGeofenceCollection"
        )
    )
)


Amplify.addPlugin(AWSLocationGeoPlugin())
Amplify.configure(config, applicationContext)

Configure Notifications (Push)

Connect to an existing Pinpoint application for push notifications.

val config = AmplifyOutputsData(
    notifications = Notifications(
        awsRegion = "us-east-1",
        amazonPinpointAppId = "abc123def456",
        channels = listOf(
            AmazonPinpointChannels.FCM,
            AmazonPinpointChannels.IN_APP_MESSAGING
        )
    )
)


Amplify.addPlugin(AWSPinpointPushNotificationsPlugin())
Amplify.configure(config, applicationContext)

Multi-category configuration

You can configure multiple services together. This example sets up Auth, Data, and Storage in a single configuration.

val config = AmplifyOutputsData(
    auth = Auth(
        awsRegion = "us-east-1",
        userPoolId = "us-east-1_abc123",
        userPoolClientId = "abcdef123456",
        identityPoolId = "us-east-1:11111111-2222-3333-4444-555555555555"
    ),
    data = Data(
        awsRegion = "us-east-1",
        url = "https://abc123.appsync-api.us-east-1.amazonaws.com/graphql",
        defaultAuthorizationType = AwsAppsyncAuthorizationType.AMAZON_COGNITO_USER_POOLS,
        authorizationTypes = listOf(
            AwsAppsyncAuthorizationType.AMAZON_COGNITO_USER_POOLS,
            AwsAppsyncAuthorizationType.AWS_IAM
        )
    ),
    storage = Storage(
        awsRegion = "us-east-1",
        bucketName = "my-app-bucket"
    )
)


Amplify.addPlugin(AWSCognitoAuthPlugin())
Amplify.addPlugin(AWSApiPlugin())
Amplify.addPlugin(AWSS3StoragePlugin())
Amplify.configure(config, applicationContext)

Environment-specific configuration

Switch between dev, staging, and production without separate JSON files:

val (region, userPoolId, clientId) = when (BuildConfig.BUILD_TYPE) {
    "debug" -> Triple("us-east-1", "us-east-1_dev123", "devClient123")
    "staging" -> Triple("us-west-2", "us-west-2_staging456", "stagingClient456")
    else -> Triple("us-east-1", "us-east-1_prod789", "prodClient789")
}


val config = AmplifyOutputsData(
    auth = Auth(
        awsRegion = region,
        userPoolId = userPoolId,
        userPoolClientId = clientId
    )
)


Amplify.configure(config, applicationContext)

amplify_outputs.json schema reference

For the full schema of all supported configuration fields, see the amplify_outputs.json reference.

Site color mode

Amplify open source software, documentation and community are supported by Amazon Web Services.

© 2026, Amazon Web Services, Inc. and its affiliates.

All rights reserved. View the site terms and privacy policy.

Flutter and the related logo are trademarks of Google LLC. We are not endorsed by or affiliated with Google LLC.