MarsalaDS

Buscar

Páginas e componentes da documentação

Instalação

Configure o registry Marsala no seu projeto e instale componentes como código-fonte, não como pacote npm fechado.

Pré-requisitos

O CLI do shadcn precisa de um app React já com Tailwind CSS v4 e alias @/* (veja o guia Vite ou Next.js do shadcn).

Sem isso, shadcn init com o base Marsala falha na validação.

1. Aplique o preset base

Projeto ainda sem components.json: use init com a URL do base. Não use add aqui — sem components.json o CLI abre o assistente genérico (Maia, Lucide) e ignora o Marsala.

pnpm dlx shadcn@latest init "https://marsala-ds.youxgroup.com.br/r/base.json" -b base -y

Isso deve gerar style: "base-nova", iconLibrary: "hugeicons" e os tokens Marsala no CSS global.

Já rodou add ou init genérico?

Se o components.json ficou com base-maia, lucide ou outro preset do shadcn, reaplique o base Marsala.

pnpm dlx shadcn@latest apply "https://marsala-ds.youxgroup.com.br/r/base.json" -y

2. Registre o namespace

Configure seu registry no arquivo components.json. Facilita instalar com @youxgroup/nome-do-componente.

{
  "registries": {
    "@youxgroup": "https://marsala-ds.youxgroup.com.br/r/{name}.json"
  }
}

3. Adicione um componente

Exemplo com button.

pnpm dlx shadcn@latest add @youxgroup/button