​

Snippet Contract

Esta página é o contrato canônico para Snippets na Corvex Store V2.

​

MUST — arquivos

snippets/{id}/snippet.jsx    REQUIRED
snippets/{id}/styles.css     OPTIONAL

​

MUST — export

export default function ProductCard({ product }) {
  return (
    <a href={product.url}>
      <span>{product.title}</span>
    </a>
  );
}

​

MUST — import no build

import ProductCard from '@corvex/snippets/product-card';

​

Props

• Sem contrato global — o autor do snippet define props.
• SHOULD documentar props no JSDoc ou no guia da section que consome.
• Dados MUST vir de data, settings ou hooks do Theme SDK — não inventar fetch ad hoc sem SDK.

​

MUST NOT

• Não listar snippet em theme.json → sections ou blocks.
• Snippets são importados em JSX — import X from '@corvex/snippets/{id}'.
• SHOULD NOT conter lógica de página inteira — use Section para composição no Editor.

​

Snippet vs Section

​

Exemplo mínimo válido

export default function Greeting({ text }) {
  return <span className="greeting">{text}</span>;
}

import Greeting from '@corvex/snippets/greeting';

export default function HelloSection({ settings = {} }) {
  return (
    <section>
      <Greeting text={settings.title || 'Olá'} />
    </section>
  );
}

​

Veja também

• Section Contract
• Product Contract — objeto típico em snippets de card