Skip to content

Cuida Design System

O Cuida é o design system open source da Sysvale, pensado para ajudar times de produto a trabalhar de modo consistente e performático na construção de aplicações do Cidade Saudável.

Imagem

Bem-vindo ao Cuida!

Instalação

  • O Cuida pode ser instalado com o npm:
bash
npm i @sysvale/cuida

Uso

  • Para usar o cuida, importe a biblioteca no seu entry point, provavelmente vai ser seu main.js ou app.js:
js
import Cuida from "@sysvale/cuida";
  • Importe os estilos do Cuida:
js
import '@sysvale/cuida/dist/style.css';
  • E registre o Cuida:
js
app.use(Cuida);
  • Caso deseje, é possível utilizar os Utils do Cuida expondo-os:
js
const cdsUtils = Cuida.utils;
app.provide('cdsUtils', cdsUtils);
  • Agora, para utilizar os componentes, basta usá-los no seu template. Como exemplo, para usar a Badge:
html
<cds-badge variant="gray"> Conteúdo </cds-badge>
  • Para utilizar os tokens do Cuida instale o sass-embedded
bash
npm install -D sass-embedded

e importe o arquivo de tokens na sua tag script.

html
<style lang="scss" scoped>
  @import 'node_modules/@sysvale/cuida/dist/@sysvale/tokens.scss';
  ...
</style>


Desenvolvimento

Configurando o projeto

  • Clone o repositório:
bash
git clone https://github.com/Sysvale/cuida.git
  • Instale as dependências:
bash
npm i

Executando o Cuida

bash
npm run docs:dev

Testando-o

  • Utilizando o docker:
bash
npm run test
  • Para utilizar o ui do vitest:
bash
npm run test:ui
  • Para visualizar o detalhamento da cobertura de testes, use o comando abaixo:
bash
npx open-cli coverage/index.html

Contribuindo

Para informações sobre como contribuir com o projeto, acesse o CONTRIBUTING.MD

Released under the Apache-2.0 License.