Introdução
O Store Theme é a camada responsável pela experiência visual e interativa da loja. É aqui que você constrói o layout, navegação, vitrines, banners, páginas de produto e todo o fluxo que o cliente final enxerga e utiliza.
Na plataforma Uappi, o Store Theme foi pensado para dar liberdade total de criação, sem abrir mão de performance, padronização e escalabilidade. Toda a comunicação com a plataforma acontece por meio da API Pública, garantindo segurança e desacoplamento entre front-end e backend.
Este guia foi criado para quem deseja:
- Desenvolver um novo tema do zero
- Customizar ou evoluir um tema existente
- Entender o fluxo completo de desenvolvimento, do ambiente local ao deploy
- Criação do projeto no GitLab da própria Uappi
- Configuração inicial do repositório
- Estrutura base do Store Theme já preparada
- A Uappi já entregou o ambiente configurado
- O repositório GitLab já existe com o projeto modelo
- Você apenas irá clonar o projeto para sua máquina e iniciar o desenvolvimento
- Entender o que é o Store Theme e qual seu papel na arquitetura da plataforma
- Preparar o ambiente de desenvolvimento local
- Clonar e rodar o projeto exemplar fornecido pela Uappi
- Compreender como funcionam persistência de dados (já configuradas)
- Conhecer a estrutura base do projeto
- Consumir a API Pública, com e sem o uso do Public SDK
- Configurar eventos de rastreamento (GTM) via Public SDK
- Boas práticas e deploy
- Este guia é focado exclusivamente em Store Theme
- Não é necessário conhecimento da API Privada
- Pontos críticos como persistência de dados já vêm resolvidos no projeto modelo
- A recomendação da plataforma é seguir a estrutura fornecida, personalizando apenas o necessário para a experiência da loja
🧩 Modelo de trabalho na Uappi
Antes de iniciar qualquer desenvolvimento, é obrigatório solicitar a configuração do ambiente do projeto junto à plataforma Uappi.Esse processo inclui:
Este guia parte do princípio de que:
Não é esperado (nem recomendado) criar um projeto do zero fora desse fluxo.
🧭 O que você vai aprender neste tópico
Ao longo deste conteúdo, você vai passar por todas as etapas necessárias para trabalhar com Store Theme na Uappi:
💡 Importante saber desde o início
🏁 Próximo passo
Agora que você entende como funciona o modelo de desenvolvimento de Store Theme na Uappi e como o ambiente é provisionado, o próximo passo é compreender o papel do Store Theme dentro da arquitetura da plataforma.