Involves Theme - Zendesk Guide

Este é o repositório do tema customizado para a Central de Ajuda (Guide) da Involves, construído com foco em performance, manutenibilidade e uma experiência de usuário moderna.

Visão Geral

O objetivo deste tema é fornecer uma base sólida e escalável para a Central de Ajuda da Involves. Ele foi desenvolvido utilizando ferramentas modernas de front-end para otimizar o fluxo de desenvolvimento e o resultado final.

Tech Stack

• Templating: Handlebars.js (Padrão do Zendesk Guide)
• Estilização: Sass (SCSS) para estilos modulares e organizados.
• Build Tool: Vite.js para um desenvolvimento rápido e otimização dos assets (CSS e JS).
• Deploy: Zendesk CLI (ZCLI) para preview e deploy do tema.

Pré-requisitos

Antes de começar, certifique-se de que você tem o seguinte software instalado:

• Node.js (versão 18 ou superior)
• Zendesk CLI (ZCLI)

Instalação e Desenvolvimento

1. Clone o repositório:

   git clone [URL_DO_SEU_REPOSITÓRIO]
   cd involves-theme-zendesk

2. Instale as dependências:

   npm install

3. Inicie o ambiente de desenvolvimento: O Vite irá monitorar as alterações nos arquivos SCSS e JS, compilando-os automaticamente para a pasta dist/.

   npm run dev

4. Preview do tema no Zendesk: Em um terminal separado, use o ZCLI para enviar os arquivos compilados para o Zendesk e gerar um link de preview.

   npm run preview

Estrutura de Pastas

• src/: Contém todos os arquivos fontes.
  • scss/: Arquivos Sass, divididos em uma arquitetura modular (ITCSS).
  • js/: Arquivos JavaScript.
  • assets/: Imagens, fontes e outros assets estáticos.
• templates/: Arquivos de template .hbs do Zendesk.
• dist/: Contém os arquivos compilados (style.css, script.js) que serão usados pelo Zendesk. Não edite arquivos nesta pasta diretamente.
• manifest.json: Arquivo de configuração do tema Zendesk.