Primeiros passos
Maka UI é a biblioteca de componentes oficial do HalfByte Design System, construída com Vue 3, Panda CSS e Ark UI.
Instalação
bash
# npm
npm install @halfbyte/maka
# bun
bun add @halfbyte/maka
# pnpm
pnpm add @halfbyte/makaPré-requisito: A lib é publicada no GitHub Packages (
@halfbyte). Configure o.npmrcdo seu projeto:@halfbyte:registry=https://npm.pkg.github.com
Configuração
Importe os estilos uma única vez no entry point da sua aplicação:
ts
// main.ts
import { createApp } from 'vue'
import '@halfbyte/maka/styles'
import App from './App.vue'
createApp(App).mount('#app')Fontes
Maka UI usa Space Grotesk (display) e Plus Jakarta Sans (corpo). Adicione ao seu index.html:
html
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link
href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700;800&family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap"
rel="stylesheet"
/>Uso básico
Importe os componentes diretamente — tree-shakeable por padrão:
vue
<script setup lang="ts">
import { Button, Input, Badge } from '@halfbyte/maka'
</script>
<template>
<Input label="Nome" placeholder="Digite seu nome..." />
<Button variant="primary">Enviar</Button>
<Badge variant="blue">Novo</Badge>
</template>Próximos passos
- Tokens de design — entenda como o sistema de tokens funciona
- Componentes — catálogo completo de todos os componentes