hydrogen

Documentos | Discussões | Registro de alterações

O hidrogênio é a pilha do Shopify para comércio sem cabeça. Ele fornece um conjunto de ferramentas, utilitários e os melhores exemplos para a construção de aplicativos comerciais dinâmicos e de alto desempenho. O Hydrogen foi projetado para se encaixar no Remix, a estrutura web full stack do Shopify, mas também fornece uma biblioteca React portátil para outras estruturas de suporte.

Legado de Hidrogênio v1

O legado do Hydrogen v1 foi movido para um repositório separado e a documentação pode ser encontrada aqui.

Começando com Hidrogênio

Requisitos:

• Node.js versão 16.14.0 ou superior
• npm (ou o gerenciador de pacotes de sua preferência, como yarn ou pnpm )

1. Instale a versão mais recente do Hydrogen:

   npm create @shopify/hydrogen@latest

2. Execute o servidor de desenvolvimento local:

   npm install
   npm run dev

3. Abra seu novo aplicativo Hydrogen em execução em http://localhost:3000.

Veja a documentação completa do Hidrogênio.

Pacotes neste repositório

O hidrogênio é organizado como um monorepo, que inclui vários pacotes que podem ser usados ​​juntos.

Pacote	Versão mais recente	Descrição	Leia-me
@shopify/hydrogen		Ferramentas opinativas, utilitários e os melhores exemplos para construir um aplicativo de comércio com Remix.	Leia-me
@shopify/hydrogen-react		Biblioteca independente e de alto desempenho de componentes, ganchos e utilitários de comércio específicos do Shopify.	Leia-me
@shopify/cli-hydrogen		Extensão de hidrogênio para Shopify CLI.	Leia-me
@shopify/create-hydrogen		Gere um novo projeto Hydrogen na linha de comando.	Leia-me
@shopify/hydrogen-codegen		Gere tipos para consultas da API Storefront automaticamente.	Leia-me
@shopify/remix-oxygen		Adaptador Remix permitindo que o Hydrogen seja executado no tempo de execução do Oxygen.	Leia-me
@shopify/mini-oxygen		Um tempo de execução local para aplicativos Hydrogen que simula o ambiente de produção do Oxygen.	Leia-me

Versionamento

Hidrogênio e reação de hidrogênio estão vinculados a versões específicas da API Shopify Storefront, que segue calver.

Por exemplo, se você estiver usando a versão 2023-01 da API Storefront, as versões 2022.1.x de hidrogênio e reação de hidrogênio serão totalmente compatíveis.

Se a atualização da versão da API Storefront incluir alterações significativas, o Hydrogen e o hydrogen-react também poderão incluir alterações significativas. Como a versão da API é atualizada a cada três meses, alterações significativas podem ocorrer a cada três meses.

Saiba mais sobre cronogramas de lançamento de API no Shopify.

Contribuindo para o Hidrogênio

Leia nosso guia de contribuição

Outros links úteis

Saiba mais sobre Hidrogênio.