Publicar uma biblioteca

Esse artigo está disponível tanto no Figma UI anterior como no novo Figma UI. Use o botão de alternância no canto inferior esquerdo da página para selecionar o UI atual. Conheça o UI3: a reformulação do Figma →

Quem pode usar este recurso

Disponível em todos os planos pagos

Requer um Licença Full com acesso de edição ao arquivo-fonte da biblioteca

Publique uma biblioteca para compartilhar elementos de design comuns (como botões, ícones, partes da IU, cores ou valores de determinadas propriedades) com o restante da equipe. Outras pessoas podem usar esses elementos de design em seus arquivos, ajudando a manter a consistência.

Ao criar um estilo, um componente ou uma variável em um arquivo, ele estará acessível apenas nesse arquivo. Para torná-lo disponível em outros arquivos, é necessário publicá-lo como uma biblioteca.

Se você fizer alterações nesses ativos ou adicionar novos, poderá publicá-los como atualizações na biblioteca. Pessoas que utilizam a biblioteca em seus arquivos podem rapidamente revisar as mudanças e atualizar seus designs automaticamente.

Observação: bibliotecas estão disponíveis apenas em planos pagos. No plano gratuito Starter, ainda é possível criar componentes e estilos, mas não publicá-los em uma biblioteca para acessá-los em outros arquivos.

Para publicar um arquivo de design como biblioteca, deve haver pelo menos um componente, estilo ou variável no arquivo. Se o arquivo estiver em seus rascunhos, será necessário movê-lo para um projeto antes da publicação.

Depois de publicado, qualquer pessoa com acesso ao arquivo de origem da biblioteca poderá utilizá-la em seus arquivos.

Dica: uma biblioteca herda seu nome do arquivo de origem. Certifique-se de dar um nome claro e significativo ao seu arquivo para que outras pessoas entendam seu propósito, como "Sistema de design Habitz", "Biblioteca UI3" ou "Kit de design para site".

Em um arquivo com componentes, estilos ou variáveis que você deseja compartilhar, selecione a aba Assets na barra lateral esquerda.
Clique no ícone Libraries. O tooltip pode exibir Review library updates se houver atualizações nas bibliotecas que você está usando no arquivo, ou Review unpublished changes se houver alterações não publicadas em seu arquivo.
Na seção This file, encontre o arquivo atual e clique em Publish.
Adicione uma descrição sobre o propósito da biblioteca ou um resumo das decisões e alterações realizadas.
Na lista de estilos, componentes ou variáveis que foram adicionados, modificados ou removidos, desmarque quaisquer ativos que você não deseja publicar. Você também pode desmarcar Changes para desmarcar tudo.
Somente para os planos Organization e Enterprise: use o menu suspenso para escolher onde publicar a biblioteca.
Clique em Publish. Uma notificação aparecerá confirmando que sua biblioteca foi publicada com sucesso.

Dica: se quiser garantir que determinados componentes, estilos ou variáveis nunca sejam publicados, você pode ocultá-los no fluxo de publicação. Clique com o botão direito em qualquer ativo na modal da biblioteca e selecione Hide when publishing. Para desfazer, clique com o botão direito novamente e selecione Show when publishing.

Por que o botão publish não está funcionando?

Se o botão de publicar estiver desativado, pode ser por um dos seguintes motivos:

Não há componentes, estilos ou variáveis no arquivo. Tente criar um novo para ver se a opção de publicação aparece.
A biblioteca não tem alterações publicáveis. Nesse caso, nada mudou desde a última publicação. Tente editar um componente, estilo ou variável na biblioteca. Você também pode verificar se os elementos de design que está editando estão ocultos na publicação.

Escolher onde publicar uma biblioteca Organization e Enterprise

Usuários dos planos Organization ou Enterprise podem publicar bibliotecas para uma equipe específica ou para toda a organização. Usuários do plano Enterprise também podem publicá-las em áreas de trabalho.

Isso ajuda a garantir que as bibliotecas alcancem o público certo. Por exemplo, você pode publicar uma biblioteca de sistema de design para toda a organização ou uma biblioteca com componentes de um aplicativo móvel para a equipe que trabalha nesse aplicativo.

Se o arquivo de origem da biblioteca tiver permissões de compartilhamento muito restritivas, o Figma solicitará que você as altere. Por exemplo, se o arquivo estiver configurado como Only invited people can access e você quiser publicá-lo para toda a organização, será necessário mudar as permissões para Everyone at your organization can access.

Publicar atualizações em uma biblioteca

Se você fizer alterações em um estilo, componente ou variável no arquivo de origem da biblioteca, essas alterações aparecerão apenas no arquivo atual até que você as publique. A publicação de atualizações segue o mesmo processo de publicação de uma biblioteca pela primeira vez.

Observação: assim que as atualizações forem publicadas, as pessoas que usam a biblioteca verão um ícone azul na barra lateral esquerda de seus arquivos. Elas poderão então revisar e aceitar as atualizações.

Dica: sempre que publicar atualizações em uma biblioteca, será solicitado que você adicione uma descrição. Isso permite comunicar decisões e mudanças às pessoas que utilizam sua biblioteca.

O Figma exibe descrições ao aceitar atualizações de uma biblioteca, bem como no histórico de versões do arquivo.

Quem pode usar este recurso

Qualquer pessoa em um plano pago.

Qualquer pessoa com acesso de editor a um arquivo pode publicá-lo nas bibliotecas da equipe.

Ao criar estilos, componentes e variáveis pela primeira vez, eles estarão disponíveis apenas no arquivo atual. Para usá-los em outros arquivos, você pode publicá-los como uma biblioteca.

Quem pode publicar estilos, componentes e variáveis?

Plano Education: membros da equipe com can edit team permissions podem publicar uma biblioteca.
Plano professional: apenas membros com um licença paga para o Figma Design na equipe podem publicar uma biblioteca.
Planos Organization e Enterprise: apenas membros com uma licença paga do Figma Design podem publicar uma biblioteca.

Publicar estilos, componentes e variáveis

Publique ativos em suas bibliotecas a partir da modal Library. Você pode escolher quais estilos, componentes e variáveis deseja publicar. O processo de publicação é o mesmo para novas bibliotecas e para alterações em bibliotecas existentes.

Existem algumas maneiras de acessar o modal da Biblioteca a partir de um arquivo:

Clique no painel Assets na barra lateral esquerda.
Clique em para abrir o modal da biblioteca.

Painel de Assets aberto na barra lateral esquerda com o cursor pairando sobre o ícone da biblioteca da equipe

Use o atalho de teclado:

Mac: ⌥ Option 3
Windows: Alt 3

Observação: as bibliotecas estão disponíveis apenas nos planos pagos. Você ainda pode criar e usar componentes e estilos no plano básico, mas não pode publicá-los para acessá-los em outros arquivos.

Publicar em uma biblioteca

Sempre que você publicar em uma biblioteca, será solicitado que adicione uma descrição. Isso permite comunicar decisões e mudanças às pessoas que utilizam sua biblioteca.

O Figma exibe descrições ao aceitar atualizações de uma biblioteca, bem como no histórico de versões do arquivo.

Publique estilos, componentes e variáveis do arquivo onde eles estão.

Abrir o modal da biblioteca a partir do arquivo ↑
Selecione a tab Libraries.
Na seção Current file, clique no botão Publish.
Adicione uma descrição sobre o propósito da biblioteca ou um resumo das decisões e alterações realizadas.
Ver uma lista de alterações na biblioteca. Isso detalha quaisquer estilos, componentes ou variáveis que foram adicionados, modificados ou removidos.
Escolha quais alterações você deseja publicar.
- Verifique os assets individuais que você deseja publicar
- Desmarque os assets individuais que você não deseja publicar
- Desmarque Changes para desmarcar todos os estilos e componentes
Quando tiver finalizado seus assets, clique no botão Publish. O Figma exibirá uma notificação para confirmar que seu arquivo foi publicado com sucesso.

Observação: se você receber um erro ao tentar publicar uma biblioteca, talvez seja necessário ajustar suas configurações de firewall →

Publicar estilos, componentes ou variáveis individualmente

Se estiver faltando estilos, componentes ou variáveis em um arquivo publicado, ou se quiser adicionar mais, você pode publicá-los individualmente.

Clique na aba Assets na barra lateral esquerda ou use o atalho do teclado:
- MacOS: ⌥ Option 2
- Windows: Alt 2
Role para baixo até a seção Hidden, que listará todos os componentes existentes no arquivo, mas que não foram publicados.
Clique com o botão direito no componente e selecione Show when publishing. Se você ocultou o componente usando o prefixo . ou o prefixo _, você precisará removê-lo.
O Figma notificará que suas atualizações foram publicadas com sucesso.

Dica: você pode publicar rapidamente um componente diretamente da tela. Clique com o botão direito no componente que deseja publicar e selecione Publish selected components.

Publicar atualizações em uma biblioteca

Se você fizer alterações em um estilo, componente ou variável já publicado, essas mudanças serão aplicadas apenas às instâncias no arquivo atual. Para que essas alterações sejam refletidas na biblioteca, será necessário publicá-las na biblioteca.

O Figma exibirá um ponto azul no ícone Libraries na barra de ferramentas superior caso haja atualizações pendentes de publicação.

Uma imagem ampliada da barra de ferramentas superior no Figma. Um cursor paira sobre o ícone de Libraries, que é representado como um livro aberto. Há um ponto azul no canto superior direito do ícone Libraries.

Observação: o ícone Libraries também exibirá um selo azul se houver atualizações disponíveis para revisão na biblioteca. Saiba mais sobre como revisar e aceitar atualizações da biblioteca →

Abra o painel Bibliotecas seguindo um destes passos:
- Clique no ícone Libraries no toolbar superior.
- Selecione o painel Assets na barra lateral esquerda e clique no ícone Libraries.
Selecione a tab Libraries.
Adicione uma descrição das decisões ou alterações realizadas. Isso será exibido no histórico de versões do arquivo e na tab Updates da modal Libraries.
Ver uma lista de alterações na biblioteca. Isso detalha quaisquer estilos e componentes que foram adicionados, modificados ou removidos.
Escolha quais alterações você deseja publicar.
- Verifique os componentes individuais que você quer publicar
- Desmarque os componentes individuais que você não deseja publicar
- Desmarque Changes para desmarcar todos os estilos e componentes
Quando finalizar seus estilos e componentes, clique no botão Publish. O Figma exibirá uma notificação confirmando que seu arquivo foi publicado com sucesso.

Observação: se você for membro de uma organização, também poderá optar por compartilhar a biblioteca com toda a organização. Isso permitirá que outros membros encontrem e utilizem os estilos e componentes desse arquivo.

Marque a caixa ao lado de Allow any member of organization to access this file antes de clicar em Publish. Saiba como adicionar e remover bibliotecas em uma organização →

Dica: se houver estilos e componentes que você não deseja compartilhar ou que ainda estão em desenvolvimento, você pode ocultá-los da publicação. Quando estiver pronto para compartilhar, basta exibi-los novamente para publicá-los e compartilhá-los.

···