{"v":{"area":"admin","slug":"matdash-assets","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/matdash-assets.md","relative_path":"docs/readme/admin/matdash-assets.md","title":"Assets Matdash","html":"<h1>Assets Matdash</h1><h2>O que e</h2><p>Registro operacional dos assets locais do Matdash usados pelo admin e por telas setoriais.</p><h2>Para que serve</h2><ul><li>manter fontes e bibliotecas Matdash versionadas junto com o deploy;</li><li>evitar uploads manuais por FTP que podem divergir do repositorio;</li><li>garantir que paginas que chamam <code>/assets/matdash/libs</code> e <code>/assets/matdash/fonts</code> encontrem os arquivos no ambiente publicado;</li><li>orientar a manutencao do pacote copiado de <code>dist/assets</code>.</li></ul><h2>Pastas versionadas</h2><ul><li><code>assets/matdash/fonts/tabler-icons</code>: CSS e fontes do Tabler Icons;</li><li><code>assets/matdash/fonts/flag-icon-css</code>: CSS e SVGs de bandeiras;</li><li><code>assets/matdash/libs</code>: plugins e bibliotecas front-end do pacote Matdash.</li></ul><h2>Politica de imagens</h2><p>As imagens de <code>assets/matdash/images</code> seguem a regra atual do <code>.gitignore</code>: a pasta fica ignorada por padrao e somente excecoes especificas sao versionadas, como <code>backgrounds/mega-dd-bg.jpg</code> e <code>svgs/caret-down.svg</code>.</p><h2>Operacao recomendada</h2><ul><li>subir assets Matdash pelo Git, nunca por FTP;</li><li>ao atualizar o pacote ThemeForest, copiar primeiro para ambiente local e revisar o diff;</li><li>versionar somente o necessario para telas em uso;</li><li>evitar substituir arquivos customizados do sistema por arquivos originais do template sem revisar regressao visual ou de navegacao.</li></ul><h2>Observacoes</h2><ul><li>o pacote ThemeForest possui <code>package.json</code> e <code>gulpfile.js</code>, mas no sistema atual o deploy consome os arquivos estaticos ja compilados em <code>assets/matdash</code>;</li><li>se uma tela passar a depender de uma nova lib do Matdash, a lib deve entrar no repositorio junto com o changelog da tela.</li></ul>"},"exp":1780849817}