tema-glow — Astro 电商模板

SHA-256: 0841b7f001fadd8ca310660151ab250dd69cb8d473213ef54ba052fe16689c72

2026-10-13T01:26:45.685Z

# Glow Commerce — loja demo do nicho de beleza

Cópia do starter [`ecomplus/store`](https://github.com/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](https://www.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

```bash
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`](https://github.com/ecomplus/store) — é subir a versão das
dependências, exatamente como as lojas em produção fazem: a
[tiasonia](https://www.tiasonia.com.br) 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`):

```bash
# 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`](https://github.com/ecomplus/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.json` — `storeId` e projeto Firebase (`npm run setup`)

> **Demo publicada:** [tema-glow.web.app](https://tema-glow.web.app) — `noindex`, com
> catálogo compartilhado de demonstração.

---

Documentação do starter: [SETUP.pt-BR.md](./SETUP.pt-BR.md) ·
[Cloud Commerce](https://github.com/ecomplus/cloud-commerce)