From 1f654e79482299f228f93e1bcbd0968f43b706c8 Mon Sep 17 00:00:00 2001 From: wpeck-amplify <107895670+wpeck-amplify@users.noreply.github.com> Date: Mon, 3 Apr 2023 10:52:11 -0700 Subject: [PATCH 1/5] fixing login instructions and CTA --- src/pages/console/adminui/start.mdx | 76 ++++++++++++----------------- 1 file changed, 30 insertions(+), 46 deletions(-) diff --git a/src/pages/console/adminui/start.mdx b/src/pages/console/adminui/start.mdx index 14d159e879e..22a52bfae1e 100644 --- a/src/pages/console/adminui/start.mdx +++ b/src/pages/console/adminui/start.mdx @@ -7,57 +7,41 @@ AWS Amplify Studio is a visual development environment for building fullstack we Amplify Studio is available in the following regions: [Amplify Studio service endpoints](https://docs.aws.amazon.com/general/latest/gr/amplify.html#amplifyadmin_region). -You can get started with or without an AWS account. Without an AWS account, you can begin modeling data for your backend and testing it locally. If you choose to create an AWS account and deploy your backend in the AWS Amplify console, an expanded set of features becomes available for configuring your backend environment. - ## Get started without an AWS account -If you are new to AWS, you don't need an AWS account to get started. You can still model and test your data before deploying to the cloud. After building your data model, you must connect an AWS account to deploy your backend environment to Amplify using Amplify Studio. The sandbox interface lets you perform the following tasks: - * Set up your data model. For instructions on creating models and setting relationships, see [Data modeling in Amplify Studio](/console/data/data-model#Data-modeling-in-the-Admin-UI). - * Test your new data model locally. - * Deploy your backend to the cloud. This requires an AWS account. - - - - -

Launch Sandbox

-

Get started without an AWS account

- - +If you are new to AWS, you don't need an AWS account to get started. Visit the [Amplify Studio Sandbox](https://sandbox.amplifyapp.com/), where you can build and test your data model, and build React forms, all without logging into AWS. ## Get started with your AWS account -If you already have an AWS account and you want to skip the sandbox experience, deploy Amplify Studio to start using all Amplify features, including DataStore, user authentication and authorization, and file storage. After you deploy a backend in Amplify, you can launch Amplify Studio from your Amplify project. Your entire team can use Studio to add new features, update app data, and manage users and groups. - - - - -

Log in to AWS console

-

Get started in the AWS Amplify console

- - - -### To get started with a new Amplify project -1. Sign in to the AWS Management Console and open AWS Amplify. Choose **Create app backend**. -2. Enter a name for your app and choose **Confirm deployment**. This deploys a default **staging** backend environment. -3. On the application information page, choose the **Backend environments** tab. -4. Choose **Launch Studio**. This automatically logs you in to Amplify Studio. - -If you already have an existing backend environment, you can enable Amplify Studio from the console. - -### To get started from an existing Amplify project - -1. Sign in to the AWS Management Console and open AWS Amplify. Or, enter `amplify console` from the Amplify Command Line Interface (CLI). -2. In the navigation pane, choose **Amplify Studio settings**. -3. Turn on **Enable Amplify Studio**. -4. In the **Backend environments** section, choose **Launch Studio**. This automatically logs you in to Amplify Studio where you can use all the Studio capabilities. +If you already have an AWS account, you can begin using all of Amplify Studio's features. After you deploy a backend in Amplify, you can launch Studio from your Amplify project. Your entire team can use Studio to add new features, update app data, and manage users and groups. + +### New Amplify project +To start using Studio, create a new project in Amplify + + Create New Project + + +Next, follow these steps to deploy and launch Amplify Studio: +1. Enter a name for your app and choose **Confirm deployment**. +1. After your app deployment is complete, select the **Backend environments** tab. +1. Select **Launch Studio**. This automatically launches Amplify Studio in a new tab. + +### Log into Studio +If you have an existing Amplify project with Studio already provisioned, you can log into Studio via the following steps: +1. Navigate to the [AWS Amplify Console]("https://console.aws.amazon.com/amplify/home") +1. Select your app from the list of apps +1. Select the **Backend environments** tab +1. Select **Launch Studio** + +### Add Studio to an existing project +If you create a new Amplify project through the CLI, Studio will need to be activated before it can be launched. Use the following steps: +1. Navigate to the [AWS Amplify Console]("https://console.aws.amazon.com/amplify/home") +1. Select your app from the list of apps +1. Select the **Backend environments** tab +1. Select **Set up Amplify Studio** +1. Toggle **Enable Amplify Studio** from Off to On +1. After Studio has been successfully provisioned, navigate back your app's information page +1. Select **Launch Studio** to open Studio in a new browser tab ## Next steps From 3326cc05818214fcb0c0a8b00f09de12d728d9a2 Mon Sep 17 00:00:00 2001 From: Wesley P <40308049+wrpeck@users.noreply.github.com> Date: Mon, 3 Apr 2023 13:24:05 -0700 Subject: [PATCH 2/5] Update src/pages/console/adminui/start.mdx Co-authored-by: Danny Banks --- src/pages/console/adminui/start.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/console/adminui/start.mdx b/src/pages/console/adminui/start.mdx index 22a52bfae1e..21b886bc0c0 100644 --- a/src/pages/console/adminui/start.mdx +++ b/src/pages/console/adminui/start.mdx @@ -28,7 +28,7 @@ Next, follow these steps to deploy and launch Amplify Studio: ### Log into Studio If you have an existing Amplify project with Studio already provisioned, you can log into Studio via the following steps: -1. Navigate to the [AWS Amplify Console]("https://console.aws.amazon.com/amplify/home") +1. Navigate to the [AWS Amplify Console](https://console.aws.amazon.com/amplify/home) 1. Select your app from the list of apps 1. Select the **Backend environments** tab 1. Select **Launch Studio** From a942dc371dda5679fc8bb61fe9bae1facb5d9bc1 Mon Sep 17 00:00:00 2001 From: Wesley P <40308049+wrpeck@users.noreply.github.com> Date: Mon, 3 Apr 2023 13:27:58 -0700 Subject: [PATCH 3/5] adding callout for regions per @djb --- src/pages/console/adminui/start.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/pages/console/adminui/start.mdx b/src/pages/console/adminui/start.mdx index 21b886bc0c0..dcfc081a1c9 100644 --- a/src/pages/console/adminui/start.mdx +++ b/src/pages/console/adminui/start.mdx @@ -33,6 +33,12 @@ If you have an existing Amplify project with Studio already provisioned, you can 1. Select the **Backend environments** tab 1. Select **Launch Studio** + + +Is your app missing from the list? Make sure the correct region is selected in the upper right-hand corner + + + ### Add Studio to an existing project If you create a new Amplify project through the CLI, Studio will need to be activated before it can be launched. Use the following steps: 1. Navigate to the [AWS Amplify Console]("https://console.aws.amazon.com/amplify/home") From e651616b82cb95613dedc6ec490963f726bceb10 Mon Sep 17 00:00:00 2001 From: wpeck-amplify <107895670+wpeck-amplify@users.noreply.github.com> Date: Tue, 4 Apr 2023 14:30:09 -0700 Subject: [PATCH 4/5] adding block switcher for clarity --- src/pages/console/adminui/start.mdx | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/src/pages/console/adminui/start.mdx b/src/pages/console/adminui/start.mdx index dcfc081a1c9..0c2a526fab5 100644 --- a/src/pages/console/adminui/start.mdx +++ b/src/pages/console/adminui/start.mdx @@ -7,15 +7,24 @@ AWS Amplify Studio is a visual development environment for building fullstack we Amplify Studio is available in the following regions: [Amplify Studio service endpoints](https://docs.aws.amazon.com/general/latest/gr/amplify.html#amplifyadmin_region). -## Get started without an AWS account +## Get started with Amplify Studio + + + + If you are new to AWS, you don't need an AWS account to get started. Visit the [Amplify Studio Sandbox](https://sandbox.amplifyapp.com/), where you can build and test your data model, and build React forms, all without logging into AWS. -## Get started with your AWS account + + Explore the Sandbox + + + -If you already have an AWS account, you can begin using all of Amplify Studio's features. After you deploy a backend in Amplify, you can launch Studio from your Amplify project. Your entire team can use Studio to add new features, update app data, and manage users and groups. + + +If you already have an AWS account, you can begin using all of Amplify Studio's features. After you deploy a backend in Amplify, you can launch Studio from your Amplify project. [Your entire team can use Studio](access-management/#to-invite-team-members-to-access-a-project) to add new features, update app data, and manage users and groups. -### New Amplify project To start using Studio, create a new project in Amplify Create New Project @@ -26,6 +35,10 @@ Next, follow these steps to deploy and launch Amplify Studio: 1. After your app deployment is complete, select the **Backend environments** tab. 1. Select **Launch Studio**. This automatically launches Amplify Studio in a new tab. + + + + ### Log into Studio If you have an existing Amplify project with Studio already provisioned, you can log into Studio via the following steps: 1. Navigate to the [AWS Amplify Console](https://console.aws.amazon.com/amplify/home) @@ -40,7 +53,7 @@ Is your app missing from the list? Make sure the correct region is selected in t ### Add Studio to an existing project -If you create a new Amplify project through the CLI, Studio will need to be activated before it can be launched. Use the following steps: +If you have [created a new Amplify project through the CLI](/cli/start/workflows/#initialize-new-project), Studio will need to be activated before it can be launched. Use the following steps: 1. Navigate to the [AWS Amplify Console]("https://console.aws.amazon.com/amplify/home") 1. Select your app from the list of apps 1. Select the **Backend environments** tab @@ -49,6 +62,7 @@ If you create a new Amplify project through the CLI, Studio will need to be acti 1. After Studio has been successfully provisioned, navigate back your app's information page 1. Select **Launch Studio** to open Studio in a new browser tab + ## Next steps You are ready to start creating and managing your application's backend in Amplify Studio. Recommended next steps: From 66a8f0e3054dd1f3f4b63a4c205b1b92402122d3 Mon Sep 17 00:00:00 2001 From: wpeck-amplify <107895670+wpeck-amplify@users.noreply.github.com> Date: Tue, 4 Apr 2023 17:13:57 -0700 Subject: [PATCH 5/5] Applied improvements recommended by rachel lee --- src/pages/console/adminui/start.mdx | 53 +++++++++++++++++++++++------ 1 file changed, 43 insertions(+), 10 deletions(-) diff --git a/src/pages/console/adminui/start.mdx b/src/pages/console/adminui/start.mdx index 0c2a526fab5..e4cd5b08d06 100644 --- a/src/pages/console/adminui/start.mdx +++ b/src/pages/console/adminui/start.mdx @@ -7,13 +7,13 @@ AWS Amplify Studio is a visual development environment for building fullstack we Amplify Studio is available in the following regions: [Amplify Studio service endpoints](https://docs.aws.amazon.com/general/latest/gr/amplify.html#amplifyadmin_region). -## Get started with Amplify Studio +## Quick Start Guide - + -If you are new to AWS, you don't need an AWS account to get started. Visit the [Amplify Studio Sandbox](https://sandbox.amplifyapp.com/), where you can build and test your data model, and build React forms, all without logging into AWS. +If you are new to AWS, you don't need an account to get started. Visit the [Amplify Studio Sandbox](https://sandbox.amplifyapp.com/), where you can model your data and build React forms, all without logging into AWS. Explore the Sandbox @@ -21,11 +21,20 @@ If you are new to AWS, you don't need an AWS account to get started. Visit the [ - + -If you already have an AWS account, you can begin using all of Amplify Studio's features. After you deploy a backend in Amplify, you can launch Studio from your Amplify project. [Your entire team can use Studio](access-management/#to-invite-team-members-to-access-a-project) to add new features, update app data, and manage users and groups. +To use all of Amplify Studio's functionality, you will need an AWS account. You can take advantage of the [AWS free tier]("https://aws.amazon.com/free") to get started with no cost. + + + Create an AWS Account + + + + + + +If you already have an AWS account, you can begin using all of Amplify Studio's features. [Log into the AWS console]("https://console.aws.amazon.com/console/home"), and click the button below to create a new project in Amplify Studio -To start using Studio, create a new project in Amplify Create New Project @@ -39,16 +48,39 @@ Next, follow these steps to deploy and launch Amplify Studio: -### Log into Studio -If you have an existing Amplify project with Studio already provisioned, you can log into Studio via the following steps: -1. Navigate to the [AWS Amplify Console](https://console.aws.amazon.com/amplify/home) +## Logging In and Creating an App + +### Log into the Amplify Console +The Amplify Console is where you build, manage, and host your Amplify applications. To log in, take the following steps: +1. [Log into the AWS console]("https://console.aws.amazon.com/console/home") +1. Search for **AWS Amplify** in the console +1. Select **AWS Amplify** to open the Amplify Console + +Alternatively, [click here to go straight to the Amplify Console]("https://console.aws.amazon.com/amplify/home") + +### Create a new Studio app +To create a new Studio app, first log into the [Amplify Console]("https://console.aws.amazon.com/amplify/home"). Once you've logged in, you can create a new app using the following steps: + +*If you have no apps in this region...* +1. Scroll to the bottom of the page +1. In the Amplify Studio section, select ["Get started"]("https://console.aws.amazon.com/amplify/home?#/deploy-backend") +1. Name your app, and select **Confirm Deployment** + +*If you already have apps in this region...* +1. Select **New app** in the upper right-hand corner +1. Select **Build an app** from the dropdown menu +1. Name your app, and select **Confirm Deployment** + +### Launch Studio +To launch Amplify Studio for your app, take the following steps: +1. Log into the [AWS Amplify Console](https://console.aws.amazon.com/amplify/home) 1. Select your app from the list of apps 1. Select the **Backend environments** tab 1. Select **Launch Studio** -Is your app missing from the list? Make sure the correct region is selected in the upper right-hand corner +**Is your app missing from the list?** Make sure the correct region is selected in the upper right-hand corner @@ -68,3 +100,4 @@ If you have [created a new Amplify project through the CLI](/cli/start/workflows You are ready to start creating and managing your application's backend in Amplify Studio. Recommended next steps: * [Build a data model](/console/data/data-model) * [Create UI components in Figma](/console/uibuilder/figmatocode/) + * [Invite your team members to collaborate](access-management/)