Welcome to Copan Platform
1. Instalação
Copan está disponível como um pacote privado npm. Para utilizar nossas ferramentas configurar o seu NPM_TOKEN conforme essa doc.
Importe as fontes
Nosso Design System precisa de 2 Fontes (Inter) carregadas.
Para isso, disponibilizamos um arquivo CSS em nossa CDN com as definições de FontFace necessárias, bastando importá-lo no projeto.
Instalação
Instale a biblioteca e suas dependências; a biblioteca de tokens e a biblioteca de ícones.
A biblioteca React Loft atualmente prevê suporte para uso de versões major 17 e 18 do React.
Para o React v17+ a biblioteca dá suporte em todas as suas versões.
Para o React v18+ a biblioteca dá suporte a partir da versão v1.21.0.
Server Side Rendering
Atenção! Se o seu projeto usa o NextJS ou SSR, é necessário adicionar uma configuração a mais para que os estilos da biblioteca sejam carregadas corretamente no server.
Para isso criamos o componente atalho StylesSSR para facilitar, a ser incluído no <head />, conforme abaixo:
Para mais informações: https://stitches.dev/docs/server-side-rendering
React Loft como peerDependency
Se o seu projeto é uma biblioteca que será utilizada por outras aplicações recomendamos que a @loft/react-loft seja definido como uma peerDependency, especificando apenas a versão major. Assim, evita-se que haja mais de uma instalação do Copan no mesmo projeto e possíveis problemas que possam ocorrer disso, tanto de fucionamento quanto disparidades visuais.
2. Suporte
Na Loft temos como princípio Engenharia Ativa e a sua dúvida pode ser (ou ter sido) de uma outra pessoa, então antes de abrir um chamado:
- Acesse a seção de Troubleshooting do Copan;
- Faça uma busca no canal do Slack
#support_squad-tech-tools; - Caso não tenha nada em relação ao que você procura execute o fluxo abaixo! :)
