{"id":17489,"library":"amplify-category-xr","title":"Amplify CLI XR Plugin","description":"The `amplify-category-xr` package, currently at version `3.4.4` as per the provided metadata, extends the AWS Amplify Command Line Interface (CLI) to allow developers to provision and manage cloud resources for Extended Reality (XR) applications. This typically included services for AR/VR/MR capabilities within Amplify-powered backends. As part of the broader AWS Amplify CLI monorepo, its release cadence historically aligned with frequent updates for bug fixes and minor features across the CLI. However, this plugin's core functionality is now deprecated as its underlying dependency, Amazon Sumerian, is no longer accepting new customers, and existing Sumerian scenes were slated to be unavailable after February 21, 2023. Therefore, while the CLI plugin exists, it no longer provisions functional resources. Its original key differentiator was abstracting complex AWS service configurations for XR, integrating with other Amplify categories like Auth and Storage.","status":"deprecated","version":"3.4.4","language":"javascript","source_language":"en","source_url":"https://github.com/aws-amplify/amplify-cli","tags":["javascript","amplify","aws"],"install":[{"cmd":"npm install amplify-category-xr","lang":"bash","label":"npm"},{"cmd":"yarn add amplify-category-xr","lang":"bash","label":"yarn"},{"cmd":"pnpm add amplify-category-xr","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"This package is a plugin for the AWS Amplify CLI and requires the CLI to function. It is not designed for standalone use.","package":"@aws-amplify/cli","optional":false}],"imports":[{"note":"This package is a CLI plugin. Its functionality is exposed via command-line interface commands, not through direct JavaScript/TypeScript imports into application code. While the command exists, it no longer provisions functional XR resources due to service deprecation.","wrong":"import { add } from 'amplify-category-xr'","symbol":"amplify xr add","correct":"amplify xr add"},{"note":"Interaction is exclusively through CLI commands. Direct programmatic import of this plugin is not the intended use case, and the command itself is impacted by underlying service deprecation.","wrong":"import { updateXr } from 'amplify-category-xr'","symbol":"amplify xr update","correct":"amplify xr update"},{"note":"The 'push' command deploys local Amplify XR configurations to the cloud. Like other XR commands, its practical utility is nullified by the deprecation of Amazon Sumerian.","wrong":"require('amplify-category-xr').push()","symbol":"amplify xr push","correct":"amplify xr push"}],"quickstart":{"code":"# Ensure Amplify CLI is installed globally\nnpm install -g @aws-amplify/cli\n\n# Initialize a new Amplify project (if not already done)\namplify init\n\n# Attempt to add an XR resource (will prompt for details)\n# Note: This command will no longer provision functional resources due to underlying service deprecation.\namplify xr add\n\n# Follow the CLI prompts, e.g., choosing a scene name and initial assets.\n\n# Push the changes to deploy the (now non-functional) XR resources to the cloud\namplify push --yes","lang":"bash","description":"Demonstrates the CLI workflow for adding and deploying an XR resource, despite its functional deprecation."},"warnings":[{"fix":"Migrate away from Amplify XR features. AWS recommends exploring alternative solutions for AR/VR/MR applications, as Amplify no longer provides direct support for this category via Sumerian.","message":"The AWS Amplify XR features, and by extension this CLI plugin, are deprecated. The underlying Amazon Sumerian service stopped accepting new customers, and existing customer scenes became unavailable after February 21, 2023. Attempting to use `amplify xr` commands will no longer provision functional XR resources.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Always run `amplify push` after `amplify add`, `amplify update`, or `amplify remove` to synchronize your local backend definition with your AWS cloud resources.","message":"Ignoring `amplify push` after making local configuration changes for any Amplify category will result in your cloud environment not reflecting the desired state. This is fundamental to Amplify CLI usage.","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Run `amplify configure` to set up or verify your AWS credentials and default region. Ensure the IAM user has appropriate permissions for all AWS services Amplify provisions.","message":"Ensure your AWS credentials and region are correctly configured using `amplify configure`. Inconsistent or incorrect region settings, or insufficient IAM permissions for the AWS account, can lead to deployment failures or inaccessible resources.","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Ensure `@aws-amplify/cli` is installed globally (`npm install -g @aws-amplify/cli`). If the issue persists, try reinstalling the CLI. Note that even if the command is found, it's deprecated.","cause":"The `@aws-amplify/cli` is either not installed, or the `amplify-category-xr` plugin itself might be missing or corrupted within the CLI installation.","error":"Command 'xr' not found"},{"fix":"Update the IAM policy attached to the AWS user configured with Amplify CLI to include permissions for Amazon Sumerian and any other related services (e.g., S3 for asset storage). However, consider the service's deprecation before investing in permission setup.","cause":"The configured AWS IAM user lacks the necessary permissions to interact with Amazon Sumerian or other XR-related AWS services.","error":"Error: User is not authorized to perform: sumerian:CreateScene on resource: arn:aws:sumerian:..."},{"fix":"Verify that `amplify push` was run successfully. Given the deprecation of Amazon Sumerian, this error is now the expected behavior for any XR resource.","cause":"This typically means an XR resource was referenced but was either not deployed correctly with `amplify push`, or was previously removed from the cloud, or the underlying Amazon Sumerian service itself has removed the scene due to its deprecation.","error":"ResourceNotFoundException: The requested scene could not be found."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}