Skip to main content

Alpha This is a new service. Help us improve it and give your feedback by email.

Step 1: Access the App - Simply Readable Walkthrough

Find your credentials and log in to the Simply Readable app

Walkthrough progress

Step 1 of 5 • 3 minutes

Step 1 3 minutes

Access the App

Get your admin credentials from CloudFormation and log in to the Simply Readable app.

Your stack should show CREATE_COMPLETE status in the us-east-1 region
Copy the AppUrl, AdminUsername, and AdminPassword from the Outputs tab
The Document Translation dashboard after logging in

Expected outcome

  • CloudFormation stack shows CREATE_COMPLETE status
  • You have copied the AppUrl, AdminUsername, and AdminPassword
  • You are logged into the Simply Readable dashboard

Navigating to CloudFormation

From the AWS Console homepage, find CloudFormation in the "Recently visited" section or by searching for "CloudFormation" in the search bar.

Finding your credentials

  1. Open the CloudFormation console

    Go to CloudFormation console in us-east-1 (N. Virginia) (opens in new tab)

  2. Find your stack

    Look for a stack named SimplyReadableStack or starting with ndx-try-simply-readable

    The status should be CREATE_COMPLETE

    Warning If the status shows CREATE_IN_PROGRESS, the deployment is still running. This scenario takes approximately 5 minutes to deploy.

    This is normal. Simply Readable provisions 12 AWS services including Cognito, AppSync, Step Functions, and CloudFront. While you wait, watch the Events tab to see resources being created in real-time.

  3. Go to the "Outputs" tab

    Click on your stack name, then select the "Outputs" tab. You will see several output values.

  4. Copy these three values

    AppUrl: The URL to access Simply Readable
    https://[random-id].cloudfront.net

    AdminUsername: The admin email address

    AdminPassword: Auto-generated secure password

Tip: If you deployed from the NDX:Try scenario page, your credentials may also be shown in the Credentials Card on that page.

Logging in to Simply Readable

  1. Open the app

    Click the AppUrl link or paste it into a new browser tab. You will see the Cognito hosted login page.

  2. Enter your credentials

    Enter the AdminUsername (email) and AdminPassword from the Outputs tab.

  3. Sign in

    Click "Sign in". You will be redirected to the Simply Readable dashboard.

What you should see

After logging in, you should see:

  • The Simply Readable dashboard with the Cloudscape UI
  • A navigation sidebar with "Translation" and "Readable" sections
  • An empty jobs list (you have not created any jobs yet)
  • Your username displayed in the header
Troubleshooting: App not loading

If the app does not load:

  • Wait 2 to 3 minutes after stack completion -- CloudFront may need time to propagate
  • Check the CloudFormation "Events" tab for any errors
  • Try refreshing the page or opening in a private/incognito window
  • Check you are using the correct URL from the Outputs tab
Troubleshooting: Login not working

If you cannot log in:

  • Double-check you copied the entire password (no trailing spaces)
  • Passwords are case-sensitive
  • If prompted to change your password, set a new one and continue
  • Try clearing your browser cache or using a private window
Troubleshooting: Page hangs after login redirect

If the page appears stuck after the Cognito redirect:

  • Open your browser developer tools (F12) and go to Application > Local Storage
  • Look for an oauthSignIn key -- if its value is "true,false", delete it
  • Refresh the page and try logging in again
  • This is a known Cognito OAuth issue that is handled automatically in most cases

Need help?

If you're stuck, check the troubleshooting section or contact us.