> 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-tema/primeiros-passos/como-instalar-o-luca-super-tema.md).

# Como instalar o LUCA super tema

Essa primeira versão do LUCA necessita que, para ser instalado na loja do seu cliente, seja criado um app personalizado dentro da loja do seu cliente. Isso permitirá criar o tema, instalar componentes e automações necessárias para a montagem da loja.

Não se preocupe, o LUCA não tem acesso a dados sensíveis da sua agência ou do seu cliente, somente o necessário para construir a loja.

## Passo 1: Criar uma Loja no LUCA Admin[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-1-criar-uma-loja-no-luca-admin)

1. **Criar uma loja no LUCA Admin:**
   * Clique em **Adicionar uma loja**.
   * Preencha os campos para identificação da loja e, ao concluir, clique em **Continuar**.
   * Dar permissões é basicamente instalar o LUCA na loja do seu cliente. Para isso, é necessário criar um app personalizado na loja do seu cliente.

![](https://luca-copilot.github.io/doc-public/assets/images/passo-1-criar-af32ead617a7cf61f5e113f7ba5bfd47.png)

## Passo 2: Criar um App Personalizado[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-2-criar-um-app-personalizado)

1. **Acesse a loja no Shopify:**
   * Vá em **Configurações > Apps e canais de vendas**.
   * Clique em **Desenvolver apps**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/95b5d0d7-e091-43cd-988f-2ace97ad1261/image.png)

1. **Permitir o desenvolvimento de apps personalizados:**
   * Clique em **Permitir o desenvolvimento de apps personalizados**.
   * Clique novamente em **Permitir o desenvolvimento de apps personalizados**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/ab08cd47-1745-496e-93a4-c94b54856b10/image.png)

1. **Criar um App:**
   * Clique em **Criar um App**.
   * Nomeie o app como **LUCA App**, ou com outro nome desejado. Porém o nome precisa começar o com termo "**LUCA**".
   * Conclua clicando em **Criar app**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/37e9caa9-ef91-496a-a1ac-df8453b75600/image.png)

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

Se o nome do app não começar com o termo "**LUCA**", pode interferir nas funções dele. Portanto nomeie sempre como "**LUCA \[o nome que desejar]**".
{% endhint %}

## Passo 3: Configurar o App[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-3-configurar-o-app)

1. **Configurar escopos da API Admin:**
   * Clique em **Configurar escopos da API Admin**.
   * Adicione todas as permissões abaixo, seguindo as etapas de exemplo:
   * Products: `write_products`, `read_products`
   * Content: `write_content`, `read_content`
   * Themes: `write_themes`, `read_themes`
   * Metaobject: `write_metaobject_definitions`, `read_metaobject_definitions`, `write_metaobjects`, `read_metaobjects`
   * Customers: `write_customers`, `read_customers`

![](https://t9013067422.p.clickup-attachments.com/t9013067422/c7ff2d02-fc56-4208-abc4-78e867d5548b/image.png)

{% hint style="info" %}
**Dica**

Sugerimos utilizar a barra de busca para digitar os tópicos e encontrar as opções com mais agilidade.
{% endhint %}

## Passo 4: Instalar o App[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-4-instalar-o-app)

1. **Instalar o App:**
   * Após salvar, clique em **Instalar app**.
   * Em seguida, clique em **Instalar**.
2. **Revelar o token necessário:**
   * Clique em **Revelar token uma vez**.
   * Copie o token.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/3438af7e-a66c-40cf-9ec8-78d1c186416e/image.png)

1. **Conectar o LUCA à loja do seu cliente:**
   * Volte ao **LUCA Admin** e cole o código no campo **Token de acesso da API Admin**.
   * Por fim, clique em **Continuar** para seguir com o passo a passo da criação da loja.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/1aff8305-20a5-48c4-8c98-0b9ed7d2102c/image.png)

## Conclusão[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#conclus%C3%A3o)

Pronto, após terminar o passo a passo da criação da loja, você já pode instalar os temas, componentes e automações necessárias para criar o seu projeto com o LUCA 🕺

Se tiver dúvidas ou sugestões, estamos à disposição no Discord ou por e-mail. Estamos aqui para ajudar!