{"id":15981922,"url":"https://github.com/thomaskn/hydrogen-vite","last_synced_at":"2025-04-04T19:17:42.013Z","repository":{"id":235173911,"uuid":"769316566","full_name":"thomasKn/hydrogen-vite","owner":"thomasKn","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-08T19:45:56.000Z","size":191,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-10T04:23:12.612Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thomasKn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-08T19:45:54.000Z","updated_at":"2024-03-08T19:46:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"9ab77bad-8b5f-4937-aa59-8314376861b0","html_url":"https://github.com/thomasKn/hydrogen-vite","commit_stats":{"total_commits":3,"total_committers":1,"mean_commits":3.0,"dds":0.0,"last_synced_commit":"ab6f4293534493e7add7d5f2e8c3408ba29ef332"},"previous_names":["thomaskn/hydrogen-vite"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomasKn%2Fhydrogen-vite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomasKn%2Fhydrogen-vite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomasKn%2Fhydrogen-vite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thomasKn%2Fhydrogen-vite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thomasKn","download_url":"https://codeload.github.com/thomasKn/hydrogen-vite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247234944,"owners_count":20905855,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-08T01:01:26.660Z","updated_at":"2025-04-04T19:17:41.995Z","avatar_url":"https://github.com/thomasKn.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hydrogen template: Skeleton\n\nHydrogen is Shopify’s stack for headless commerce. Hydrogen is designed to dovetail with [Remix](https://remix.run/), Shopify’s full stack web framework. This template contains a **minimal setup** of components, queries and tooling to get started with Hydrogen.\n\n[Check out Hydrogen docs](https://shopify.dev/custom-storefronts/hydrogen)\n[Get familiar with Remix](https://remix.run/docs/en/v1)\n\n## What's included\n\n- Remix\n- Hydrogen\n- Oxygen\n- Shopify CLI\n- ESLint\n- Prettier\n- GraphQL generator\n- TypeScript and JavaScript flavors\n- Minimal setup of components and routes\n\n## Getting started\n\n**Requirements:**\n\n- Node.js version 16.14.0 or higher\n\n```bash\nnpm create @shopify/hydrogen@latest\n```\n\n## Building for production\n\n```bash\nnpm run build\n```\n\n## Local development\n\n```bash\nnpm run dev\n```\n\n## Setup for using Customer Account API (`/account` section)\n\n### Enabled new Customer Account Experience\n\n1. Go to your Shopify admin =\u003e Settings =\u003e Customer accounts =\u003e New customer account\n\n### Setup public domain using ngrok\n\n1. Setup a [ngrok](https://ngrok.com/) account and add a permanent domain (ie. `https://\u003cyour-ngrok-domain\u003e.app`).\n1. Install the [ngrok CLI](https://ngrok.com/download) to use in terminal\n1. Start ngrok using `ngrok http --domain=\u003cyour-ngrok-domain\u003e.app 3000`\n\n\u003e [!IMPORTANT]\n\u003e To successfully interact with the Customer Account API routes you will need to use the ngrok domain during development instead of localhost\n### Include public domain in Customer Account API settings\n\n1. Go to your Shopify admin =\u003e `Hydrogen` or `Headless` app/channel =\u003e Customer Account API =\u003e Application setup\n1. Edit `Callback URI(s)` to include `https://\u003cyour-ngrok-domain\u003e.app/account/authorize`\n1. Edit `Javascript origin(s)` to include your public domain `https://\u003cyour-ngrok-domain\u003e.app` or keep it blank\n1. Edit `Logout URI` to include your public domain `https://\u003cyour-ngrok-domain\u003e.app` or keep it blank\n\n### Add the ngrok domain to the CSP policy\n\nModify your `/app/entry.server.tsx` to allow the ngrok domain as a connect-src\n\n```diff\n-  const {nonce, header, NonceProvider} = createContentSecurityPolicy()\n+  const {nonce, header, NonceProvider} = createContentSecurityPolicy({\n+   connectSrc: [\n+     'wss://\u003cyour-ngrok-domain\u003e.app:*', // Your ngrok websocket domain\n+   ],\n+ });\n```\n\n### Prepare Environment variables\n\nRun [`npx shopify hydrogen link`](https://shopify.dev/docs/custom-storefronts/hydrogen/cli#link) or [`npx shopify hydrogen env pull`](https://shopify.dev/docs/custom-storefronts/hydrogen/cli#env-pull) to link this app to your own test shop.\n\nAlternately, the values of the required environment variables \"PUBLIC_CUSTOMER_ACCOUNT_API_CLIENT_ID\" and \"PUBLIC_CUSTOMER_ACCOUNT_API_URL\" can be found in customer account api settings in the Hydrogen admin channel.\n\n\u003e [!IMPORTANT]\n\u003e Note that `mock.shop` doesn't supply these variables automatically and your own test shop is required for using Customer Account API\n\n\u003e [!NOTE]\n\u003e B2B features such as contextual pricing is not available in SF API with Customer Account API login. If you require this feature, we suggest using the [legacy-customer-account-flow](https://github.com/Shopify/hydrogen/tree/main/examples/legacy-customer-account-flow). This feature should be available in the Customer Account API in the 2024-04 release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthomaskn%2Fhydrogen-vite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthomaskn%2Fhydrogen-vite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthomaskn%2Fhydrogen-vite/lists"}