Requisitos de design

O objetivo desse documento é tornar os requisitos de construção e homologação de design mais transparentes. Esses requisitos foram categorizados por urgência e obrigatoriedade.

Categorização de Urgência

Prioridade Alta

Itens marcados com essa tag são temas de importância primária, que devem ter a atenção desde o primeiro momento. Se os itens não estiverem de acordo, a homologação pode ser recusada.

Prioridade Média

Itens marcados com essa tag são temas de prioridade secundária, que devem ter a atenção ao longo do desenvolvimento. Se os itens não estiverem de acordo, a homologação pode ser pausada até que os itens sejam contemplados.

Prioridade Baixa

Itens marcados com essa tag são temas de prioridade secundária, que devem ter a atenção ao longo do desenvolvimento. Se os itens não estiverem de acordo, a homologação pode ser pausada até que ajustes sejam feitos.

Categorização de Obrigatoriedade

Obrigatório

Todos os itens marcados com essa tag devem ser verificados e contemplados, não importa qual seja a solução apresentada.

Recomendado

Todos os itens marcados com essa tag devem ser verificados e avaliados, segundo a necessidade e contexto em que o aplicativo está inserido. Ou seja, deve ser contemplado se o aplicativo apresentar caso de uso ou elemento similar.

Uso do NubeSDK

Prioridade alta

⏰ Prazo de vigência: 5 de junho de 2026

A partir de 5 de junho de 2026, a adoção do NubeSDK passa a ser obrigatória para a aprovação na homologação. Apps submetidos após essa data não serão aprovados sem o uso do SDK.

Para revisores: a partir do prazo, verificar como parte do fluxo de aprovação se o app foi desenvolvido com o NubeSDK. Apps em modelo legado (uso de document, window, jQuery ou manipulação direta do DOM) não devem ser aprovados.

Nesse item, o parceiro deve garantir que o aplicativo foi desenvolvido utilizando o NubeSDK — o modelo recomendado para apps que rodam no storefront e checkout da Nuvemshop.

Descrição	Link	Obrigatoriedade
App desenvolvido com NubeSDK (a partir de 5 de junho de 2026)	Guia de migração	Obrigatório
Não utiliza document, window, jQuery ou DOM direto	Guia de migração	Obrigatório

Antes de submeter, confirme que:

• O app está implementado com o NubeSDK e roda dentro de um Web Worker.
• Não há dependências de manipulação direta do DOM, document, window ou bibliotecas como jQuery.
• A interface é construída com os componentes do NubeSDK e os UI Slots apropriados.

🔍 Verifique com o NubeSDK DevTools

Use o NubeSDK DevTools (extensão do Chrome) para confirmar rapidamente se o app está rodando com o NubeSDK: a seção Apps lista os aplicativos construídos com o SDK e permite inspecionar componentes, eventos e estado em tempo real.

Para mais contexto sobre o prazo, consulte a visão geral da Homologação e a visão geral de Aplicativos .

Uso de Templates Nimbus

Prioridade alta

Nesse item devemos nos atentar ao uso de templates Nimbus, visando atingir uma maior consistência visual com os produtos Nuvemshop.

Descrição	Link	Obrigatoriedade
Página de estado vazio e inicial	Ver diretriz	Obrigatório
Página de erro	Ver diretriz	Obrigatório
Página de formulários	Ver diretriz	Recomendado
Modal de confirmação	Ver diretriz	Recomendado
Página de ajustes	Ver diretriz	Recomendado
Página de tabela simples	Ver diretriz	Recomendado
Página de tabela de produtos	Ver diretriz	Recomendado
Limites de personalização de templates	Ver diretriz	Obrigatório

Uso de Componentes e Patterns

Prioridade alta

Nesse item devemos nos atentar à atribuição dos componentes e padrões segundo suas respectivas documentações.

Descrição	Link	Obrigatoriedade
Componentes atômicos e compostos	Ver diretriz	Obrigatório
Patterns de composição	Ver diretriz	Recomendado
Componentes de formulários	Ver diretriz	Recomendado
Limites de personalização e flexibilidade	Ver diretriz	Obrigatório

Uso de Conceitos de UX/UI

Prioridade média

Nesse item devemos nos atentar aos comportamentos e disposição de elementos, visando atingir uma maior consistência com os produtos Nuvemshop.

Descrição	Link	Obrigatoriedade
Priorização e organização de ações e conteúdos	Ver diretriz	Obrigatório
Sinalização de status e padronização de elementos	Ver diretriz	Recomendado
Mensagens de feedback e confirmações	Ver diretriz	Recomendado
Processamento e carregamento de informação	Ver diretriz	Recomendado
Organização de dados em tabelas	Ver diretriz	Recomendado
Responsividade e alinhamento dos elementos	Ver diretriz	Obrigatório
Organização e sinalização em formulários	Ver diretriz	Recomendado

Uso de Conceitos de UX Writing

Prioridade baixa

Nesse item devemos nos atentar aos textos das interfaces e seus respectivos elementos, visando atingir uma melhor experiência e compreensão do usuário.

Descrição	Link	Obrigatoriedade
Nomenclatura de apps e telas	Ver diretriz	Obrigatório
Fundamentos de UX Writing	Ver diretriz	Obrigatório
Tom de voz nuvemshop	Ver diretriz	Obrigatório
Padrões de texto	Ver diretriz	Obrigatório