Getting started with Oxygen

• You have the staff role on the Shopify store that you're working with.
• You have Apps and channels permissions on the Shopify store that you're working with.
• The Shopify store that you're working with isn't a development store.

The Hydrogen sales channel enables the store that you're working on to use Oxygen for managing Hydrogen storefronts.

The Hydrogen sales channel doesn't replace or change the online store channel of the store that you're working on, or your live storefront.

You can install the Hydrogen sales channel with the following procedure, or you can install it from the Shopify App Store.

1. From your Shopify admin, beside Sales channels, click >.

2. Click All recommended sales channels.

3. Click Hydrogen.

4. Click Add.

The Shopify GitHub app enables you to connect a GitHub account to your Shopify admin. This connection enables you to make and track changes to Hydrogen storefront code, and enables you to collaborate with other developers to share progress.

1. Select the GitHub account that will use the Hydrogen storefront GitHub repository.

   If the GitHub account that you want to use isn't in the list, then click Add account to add the GitHub account.

2. If you're prompted to authorize and install the Shopify GitHub app, then accept the prompt.

3. Select whether you want to install the app on your personal account or in an organization.

   If the repository belongs to an organization where you don't have rights to install an app, then you might need to request that your administrator approve the installation before proceeding.

4. Continue to Create a GitHub repository.

If you've already created a GitHub repository with Hydrogen storefront code, then skip to Connect the Hydrogen sales channel to a GitHub repository.

When you create a new GitHub repository from the Shopify admin, Shopify adds the Hydrogen starter template code, injects Oxygen deployment secrets, and adds the Oxygen deployment workflow.

1. From your Shopify admin, under Sales channels, click Hydrogen.
2. In the Hydrogen storefronts interface, click Create storefront.
3. Under Account, select an account that will own the Hydrogen Git repository.
4. Under Repository, type the name for the new Hydrogen Git repository.
5. Optional: Check Create as a public repository.
6. Click Create.

In rare circumstances, when you have SSO enabled on your organization, the connection to your GitHub account might fail but show a successful connection. To rebuild the connection, you can revoke the Shopify GitHub app's access to your account through your GitHub settings, and then ensure that you're logged in and have an active SAML session before completing the setup process again.

• Create a Hydrogen storefront.
• Connect a Hydrogen storefront to an existing Hydrogen Git repository.