Skip to content

Primeros pasos ​

Instala el paquete, importa los componentes que necesites y listo — los estilos vienen con la librería.

Instalación ​

bash
1pnpm add @dowardev/herdrate-vue

O con npm:

bash
1npm install @dowardev/herdrate-vue

Vue es una peer dependency: la librería requiere vue ^3.4 y no lo empaqueta, así que asegura que tu proyecto ya tenga Vue 3.4 o superior instalado.

prettier ^3 es una segunda peer dependency opcional, y solo hace falta si formateas código tú mismo: la librería carga Prettier únicamente cuando le pasas a <CodeBlock> un formatter construido con usePrettierFormatter(). Instala prettier por tu cuenta (junto con los plugins de los lenguajes que uses — nunca se instalan solos) si ese es tu plan.

Importación ​

Todos los componentes se exportan desde la raíz del paquete:

ts
1import { Button, Panel } from '@dowardev/herdrate-vue';

Los composables y los tipos vienen del mismo punto de entrada:

ts
1import { useDesign, useToast, DEFAULT_COLOR } from '@dowardev/herdrate-vue';2import type { Color, Fill, DesignLine } from '@dowardev/herdrate-vue';

El paquete expone una única export raíz (.). No hay subpaths por componente, así que @dowardev/herdrate-vue/button no existe — importa siempre desde @dowardev/herdrate-vue.

El paquete es solo ESM: publica la condición import y no una condición require, así que require() desde CommonJS no resuelve. Usa un build ESM, o un import() dinámico desde CommonJS.

Estilos ​

El CSS se inyecta automáticamente apenas importas un componente. No hay que importar ninguna hoja de estilos ni configurar ningún archivo CSS: con importar un componente alcanza.

Uso ​

vue
1<script setup lang="ts">2import { Button, Panel } from '@dowardev/herdrate-vue';3</script>45<template>6  <Panel divider>7    <template #header>Demo de panel</template>8    <Button color="primary" @click="handleClick">Click me</Button>9    <template #footer>Footer del panel</template>10  </Panel>11</template>

Ejemplo en vivo ​

El mismo markup, renderizado por este sitio:

📦 Demo de panel
Este panel se renderiza en vivo desde el markdown de esta página.
────
PrimarySuccessWarningDanger

Próximos pasos ​