# Step 6.1. Deployments with GitHub

{% hint style="info" %}
Cisec - is a project completely based on Shopify's Hydrogen so project deployment is completely compliant with Hydrogen, so please follow Hydrogen's implementation guide for the clearest view.

👉  <https://shopify.dev/docs/custom-storefronts/hydrogen/deployments>
{% endhint %}

## Deployments Ciseco with GitHub

Hydrogen supports CI/CD with GitHub out of the box. If you connect the [Hydrogen channel](https://shopify.dev/docs/custom-storefronts/hydrogen/fundamentals#hydrogen-channel) to GitHub, then Oxygen will automatically deploy every time you push or merge changes in your Hydrogen repository.

When using Hydrogen with GitHub, you have two options:

* [Connect an existing Hydrogen app repository](https://shopify.dev/docs/custom-storefronts/hydrogen/deployments/github#connect-an-existing-repo)
* [Scaffold a new repository from the Shopify admin](https://shopify.dev/docs/custom-storefronts/hydrogen/deployments/github#create-a-new-repo)

### Requirements  <a href="#requirements" id="requirements"></a>

* A Shopify account on a [supported plan](https://shopify.dev/docs/custom-storefronts/hydrogen/fundamentals#supported-plans).
* A GitHub account.
* The Ciseco - Hydrogen project has been pushed to your GitHub repo.
* The [Shopify GitHub App](https://github.com/marketplace/shopify-online-store/) is installed on your GitHub account.

### Connect an existing repo  <a href="#connect-an-existing-repo" id="connect-an-existing-repo"></a>

You can [upload your Ciseco repository to GitHub](https://docs.github.com/en/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#adding-a-local-repository-to-github-using-git) and then connect it to Shopify.

#### Step 1: Connect your GitHub repo to the Hydrogen channel  <a href="#step-1-connect-your-github-repo-to-the-hydrogen-channel" id="step-1-connect-your-github-repo-to-the-hydrogen-channel"></a>

1. In the Shopify admin, under **Sales channels**, click **Hydrogen**.
2. Click **Create storefront**.
3. Type a name for your new storefront. The name can be edited later.
4. Make sure **Set up GitHub continuous deployment now** is selected.
5. Select your GitHub account or organization from the dropdown.
6. Select the repository for your Ciseco Hydrogen storefront.
7. Click **Connect**.

Oxygen pulls a copy of your Hydrogen app code base and automatically creates a preview deployment. The Shopify GitHub app also opens a pull request in your repo to add a GitHub Actions workflow file to handle future deployments.

#### Step 2: Merge your Oxygen workflow file  <a href="#step-2-merge-your-oxygen-workflow-file" id="step-2-merge-your-oxygen-workflow-file"></a>

The Shopify GitHub app automatically opens a pull request to create this file when you connect a repo:

![Hydrogen storefront overview page with an alert banner asking to review and merge a pull request on GitHub](https://shopify.dev/assets/custom-storefronts/hydrogen/oxygen-pr-5db72aa12e9d14d9334acab6da5b1afc818a3b36c6572b2f4887f8202e84a9b0.png)

Follow these steps to finish configuring your Hydrogen app for continuous deployment to Oxygen:

1. In the Hydrogen channel, click the name of the storefront that you just created.
2. Click **Review and merge on GitHub** to open the pull request in a new tab.
3. Follow GitHub’s prompts to [merge the PR](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
4. Close the tab to return to the Hydrogen storefront overview.

Oxygen will automatically create a new deployment in your production environment and continue watching your repo for updates. Each time you push one or more commits to your repo, Oxygen will create a new preview deployment with your changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nghiaxchis.gitbook.io/ciseco-hydrogen-shopifys-headless-theme/ciseco-with-development-store/step-6.1.-deployments-with-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.