> For the complete documentation index, see [llms.txt](https://docs.luca.global/boas-vindas/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luca.global/boas-vindas/luca-app/primeiros-passos/como-instalar-componentes.md).

# Como instalar componentes

Usar o LUCA App é muito simples, mas precisamos prestar atenção a alguns pontos importantes para que funcione corretamente.

## Selecionar Tema

Antes de instalar seus componentes, o primeiro e importante passo é selecionar o tema onde deseja instalar os componentes LUCA.

<figure><img src="https://2941734035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZLdlCcL2gjzB3oisYTc%2Fuploads%2Fit1NdNS1cDYtikAqUSP7%2Fimage.png?alt=media&amp;token=faa8c729-549a-4d21-a114-d07834f9db90" alt=""><figcaption></figcaption></figure>

### Desbloqueie o App no Tema

1. Se o app no seu tema estiver bloqueado, um alerta irá aparecer.
2. Clique em "Ativar agora" para ser levado ao editor do Shopify > Apps, onde você verá o app do LUCA.

<figure><img src="https://2941734035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZLdlCcL2gjzB3oisYTc%2Fuploads%2FHU2GOBOQ2PjL0DEMDchr%2Fimage.png?alt=media&amp;token=88fca8f1-b9aa-49d3-b293-a737660ad764" alt=""><figcaption></figcaption></figure>

3. Clique na chave ao lado do nome do app para ativá-lo.

<figure><img src="https://2941734035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZLdlCcL2gjzB3oisYTc%2Fuploads%2FWe1ss5Pi5GLmKEaNICsO%2Fimage.png?alt=media&amp;token=bc16ebea-71de-4f90-a58a-f4420c7c8751" alt=""><figcaption></figcaption></figure>

4. Volte ao LUCA e instale seus componentes.

{% hint style="warning" %}
**Atenção**

É raro, mas possível, ocorrer alguma falha de instalação. Nesse caso, um alerta informará a falha. Clique em "Solicitar ajuda" para entrar em contato com nosso suporte, que irá ajudar a resolver o problema.
{% endhint %}

## Instalando Componentes

1. Uma vez ativo, busque o componente desejado.
2. Clique em "Instalar".
3. O componente estará disponível para uso no editor do Shopify.

<figure><img src="https://2941734035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZLdlCcL2gjzB3oisYTc%2Fuploads%2Fat306jSFwZzsVYNCnmdU%2Fimage.png?alt=media&amp;token=4cf0168b-be30-44f4-9d00-48120b5b5003" alt=""><figcaption></figcaption></figure>

### Inserindo um Componente no Tema

1. Acesse o tema selecionado: Loja virtual > Temas > Personalizar.
2. No editor do Shopify, clique no ícone azul de "+" para adicionar uma seção na barra lateral ou no palco principal.
3. Busque pelo componente instalado.
4. Clique nele para adicionar ao projeto.
5. Pronto, agora é só configurar!

<figure><img src="https://2941734035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZLdlCcL2gjzB3oisYTc%2Fuploads%2FM4QzJywgIUBaML26obEM%2Fimage.png?alt=media&amp;token=f5808550-03a8-4b17-8f1f-7cd112a6e0aa" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

#### Não encontrou a informação que procurava?

Entre em contato conosco via [Discord](https://discord.com/invite/Mgq9GkgawF), ou [envie um e-mail](mailto:suporte@luca.global) com sua dúvida que nosso time de suporte irá lhe atender assim que possível.
{% endhint %}