Skip to content

docs: add Arcade installation walkthrough video to getting started guide#572

Open
AbhishekDoshi26 wants to merge 5 commits into
mainfrom
feat/arcades
Open

docs: add Arcade installation walkthrough video to getting started guide#572
AbhishekDoshi26 wants to merge 5 commits into
mainfrom
feat/arcades

Conversation

@AbhishekDoshi26

Copy link
Copy Markdown
Member

Status

READY

Description

This PR embeds the 2-minute Arcade walkthrough video into getting-started/index.mdx, replacing the previous TODO placeholder. The HTML embed code was formatted as valid JSX so it properly parses and renders within the MDX environment.

https://app.arcade.software/share/ubNeLVcVK0dWIoM33oPg

@AbhishekDoshi26 AbhishekDoshi26 requested a review from tomarra June 29, 2026 12:40
@tomarra

tomarra commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Acrade notes

  • Create your free Shorebird account to get started (remove the "instant access to all features")
  • For the login step I would remove SSO as its not going to be applicable to most people
  • On the guides section you have the 1Password popup showing which should be removed
  • Feels like logging in and then pointing them back to the docs is recursive. Like I'm almost going backwards.
  • Paste the command in your terminal to get the Shorebird CLI installed (missing the CLI word)
  • The "Stay focused on the terminal" and "watch as shorbird..." items can be dropped, fluff. Go right to the end of the install.
  • We should consider using a demo account instead of your email address in there so we have a demo one to use going forward as well. Just making a new gmail if we dont have one of like "shorebird_demo@gmail.com"
  • In the future it would be good to use a clean install of chrome or some other browser that then seeing all your extensions and profile.
  • Same thing for the Menu bar. There are apps out there that will clean that up and make it so nothing is there in order to keep peoples focus on the content.

@tomarra

tomarra commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

I've updated the branch to include the "ArcadeEmbed" component, lets use that as well.

@dawn-ducky

Copy link
Copy Markdown
Contributor
  • We should consider using a demo account instead of your email address in there so we have a demo one to use going forward as well. Just making a new gmail if we dont have one of like "shorebird_demo@gmail.com"

We have the ability to obfuscate emails and personal information in Arcade. We do likely need a demo account though for when we want to do live demos so we're not logging into our personal accounts. Even using a demo account that should be obfuscated.

@dawn-ducky

Copy link
Copy Markdown
Contributor

Arcade updates:

Headers need to be all upper case or sentence case not camel case.
Remove exclamation points.

Title slide change sub-title to " How to configure Shorebird." No exclamation points. Also anytime we are writing for a user it should be "you" not "we."

Obfuscate names and personal information in the terminal windows

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants