Skip to content

Repository files navigation

Glow Commerce — loja demo do nicho de beleza

Cópia do starter ecomplus/store tematizada para cosméticos, skincare e maquiagem. Serve de vitrine navegável para a hipótese de nicho que hoje só existe como página de venda no site institucional.

  • Marca e copy: www.e-com.plus/src/config/brands.ts, objeto glowCommerce (rota /demo/glow-commerce).
  • Argumentos do nicho: www.e-com.plus/src/pages/segmentos/beleza.astro.
  • Vitrine do nicho: www.e-com.plus/src/components/beleza/vitrine/.
  • Referência de mercado: rituaria.com.br — catálogo organizado por benefício, kits vendidos como "rituais", frete grátis a partir de R$ 199, 3x sem juros e 5% no Pix.

Protótipo interno. Nome, logo e domínio são placeholders. A e-com.plus não tem case publicado de beleza: o material do nicho usa Lado Rosa/Lado Fit e a migração multimarca como prova de operação, com essa ressalva explícita.

O que foi customizado em relação ao starter

Arquivo O que mudou
functions/ssr/content/settings.json Nome, descrição, domínio, logo/ícone, primaryColor rosa profundo + secondaryColor pêssego, 5% no Pix, 3x sem juros, frete grátis a partir de R$ 199
functions/ssr/tailwind.config.js Escala neutra nude/blush no lugar do cinza padrão, raio de borda mais suave
functions/ssr/content/layout.json Pitch bar (frete, Pix/parcelamento, assinatura), títulos das listas do rodapé, ogImage
functions/ssr/content/pages/home.json Hero de 2 slides, 3 vitrines de produto, grade de 3 banners e a seção de nicho
functions/ssr/src/sections/NichoBelezaSection.astro Novo. Navegação por necessidade da pele, seletor de tom, ativos declarados e chamada de assinatura
functions/ssr/src/sections/_Sections.astro Registro da seção customizada c:nicho-beleza
functions/ssr/content/extra-pages/ Contato, trocas (troca de tom, produto lacrado, reação alérgica) e termos em PT-BR
functions/ssr/public/img/uploads/ Banners do Unsplash; imagens de demo do starter removidas. Créditos em CREDITOS.md

Por que a seção de nicho é um componente, e não HTML no CMS

O UnoCSS/Tailwind desta stack varre apenas ./src/** — classe utilitária escrita dentro de content/pages/*.json (seção custom-html) não gera CSS. Por isso a vitrine do nicho é um .astro em src/sections/, registrado pela convenção c: que o _Sections.astro já previa.

Rodando

npm i
npm run dev     # http://localhost:3000
npm run build

O catálogo é remoto: sem uma loja E-Com Plus configurada (npm run setup), as vitrines de produto vêm vazias — o hero, os banners e a seção de nicho renderizam normalmente.

Pendências conhecidas

  • O seletor de tom é maquete estática. Não filtra o catálogo. Ligar de verdade depende de as variações estarem cadastradas como especificação de produto e isso virar filtro de busca. Está marcado no comentário do componente.
  • Logo e ícone são wordmarks SVG placeholder, com o texto em <text>. Ao definir a identidade, vetorizar o texto.
  • As rotas (/s/acne, /s/skincare, /rituais…) só respondem depois que o catálogo tiver as categorias e especificações correspondentes.
  • Decisão de cor em aberto: a referência de mercado opera num neutro frio, quase preto; aqui o neutro é quente (nude/blush), seguindo a paleta de brands.ts. Validar qual lê melhor antes de fechar a identidade.
  • Conjunto de ícones segue o padrão do starter (heroicons). Trocar exige adicionar @iconify-json/<set> às dependências.

Como atualizar a base da plataforma

Este repositório é uma casca fina. O storefront, os componentes e a lógica de loja moram nos pacotes @cloudcommerce/*, não aqui. Atualizar o tema para uma versão nova da plataforma não é fazer merge com o starter ecomplus/store — é subir a versão das dependências, exatamente como as lojas em produção fazem: a tiasonia tem mais de 260 commits Update to v no próprio repositório e nenhum merge com o starter.

Todos os pacotes @cloudcommerce/* andam na mesma versão, na raiz e em cada grupo de functions (ssr, many, with-apps):

# 1. ver a versão mais recente e o changelog
npm view @cloudcommerce/cli version
# https://github.com/ecomplus/cloud-commerce/releases

V=2.61.4   # troque pela versão alvo

# 2. raiz
npm i -D @cloudcommerce/cli@$V @cloudcommerce/eslint@$V

# 3. cada grupo de functions
(cd functions/ssr && npm i \
  @cloudcommerce/api@$V @cloudcommerce/firebase@$V @cloudcommerce/ssr@$V \
  @cloudcommerce/i18n@$V @cloudcommerce/storefront@$V @cloudcommerce/types@$V)
(cd functions/many && npm i \
  @cloudcommerce/feeds@$V @cloudcommerce/firebase@$V @cloudcommerce/passport@$V)
(cd functions/with-apps && npm i \
  @cloudcommerce/events@$V @cloudcommerce/firebase@$V @cloudcommerce/modules@$V)

# 4. validar antes de commitar
npm run build

# 5. commitar no padrão das lojas em produção
git commit -am "Update to v$V"

Se o build quebrar depois de atualizar, a correção pertence ao cloud-commerce, não a este repositório. Aqui só entra o que é do tema: functions/ssr/src/, functions/ssr/content/ e functions/ssr/public/.

Este repositório é um template

Use "Use this template" no GitHub para começar uma loja a partir deste tema. O repositório gerado é independente: não existe upstream para puxar, e a manutenção segue o fluxo de versão acima.

Antes de ir ao ar, troque o que é placeholder:

  • functions/ssr/content/settings.json — nome, domínio, logo, cores, contato
  • functions/ssr/public/img/uploads/ — logo, ícone e banners (as fotos atuais vêm do Unsplash; créditos em CREDITOS.md)
  • functions/ssr/content/extra-pages/ — contato, trocas e termos
  • functions/ssr/public/robots.txt — hoje bloqueia tudo, porque a demo é noindex
  • functions/*/config.jsonstoreId e projeto Firebase (npm run setup)

Demo publicada: tema-glow.web.appnoindex, com catálogo compartilhado de demonstração.


Documentação do starter: SETUP.pt-BR.md · Cloud Commerce

Releases

Packages

Contributors

Languages