Introducción
Gota es la librería de íconos de Flouvia: íconos dibujados a mano sobre una retícula de 24, con esquinas continuas y un solo trazo, en contorno y en relleno, y en cualquier peso del ligero al negrita. Cada ícono es un módulo: tu app carga solo los que importa.
Hoy son más de mil íconos y la primera versión sale con 10,000. Hasta entonces, esta guía describe el paquete tal como se publicará.
Instalación
Gota llega a npm con su primera versión, como @flouvia/gota, con licencia MIT. Cada versión trae también un ZIP con los SVG, los Vector Drawables de Android, los símbolos de Xcode y la fuente.
Para diseñar, una librería para Figma con cada ícono como componente, con su estilo y su peso como propiedades, llega a Figma Community con la misma versión.
Mientras tanto ya puedes usarla con tu agente de IA: su servidor MCP es público (ver Agentes de IA).
React
Importa los íconos que usa cada página. Cada componente lleva solo los datos de su ícono.
import { BellIcon, MailIcon } from '@flouvia/gota/react/icons';
<MailIcon />
<BellIcon variant="fill" weight="light" scale="large" />
<BellIcon slash /> Cuando el nombre llega en tiempo de ejecución, Icon recibe cualquier ícono del set por su nombre:
import { Icon } from '@flouvia/gota/react';
<Icon name="bell" /> Con IconBase, un mismo lugar puede cambiar de ícono y animar el cambio: menú y cerrar se transforman, una insignia se dibuja y el relleno sube como un líquido.
import { IconBase } from '@flouvia/gota/react';
import { CloseIcon, MenuIcon } from '@flouvia/gota/icons';
<IconBase icon={open ? CloseIcon : MenuIcon} transition="auto" /> Props
Las mismas en React, Vue, Svelte y Astro.
- variant
-
outline·fillContorno o relleno. - weight
-
light·regular·bold· de0.9a2.1·autoEl trazo. Conauto, iguala el peso del texto que lo rodea. - enclosure
-
circle·squareLo encierra en un círculo o en un cuadrado. - slash
-
trueLo tacha. Si el ícono tiene su versión tachada dibujada a mano, gana esa. - scale
-
small·medium·largeSu tamaño junto al texto: por omisión mide1emy baja-0.125em, como una letra. - size
- número o medida Un tamaño fijo, en lugar de seguir al texto.
- value
- de
0a1En el wifi, la batería, el volumen o un medidor: el valor que muestran. Un cambio se anima. - effect · play
-
auto·hover·once·loopSu gesto propio (la campana suena, el engrane gira) y cuándo se hace. - transition
-
autoAnima el cambio de ícono, de tachado o de relleno (React, Vue y Svelte). - rtl
-
trueRefleja los íconos de dirección en idiomas de derecha a izquierda. - aria-label
- texto Con él, el ícono se anuncia; sin él, es decorativo y queda oculto para los lectores de pantalla.
Vue, Svelte y Astro
<script setup>
import { BellIcon } from '@flouvia/gota/vue/icons';
</script>
<template>
<BellIcon variant="fill" weight="bold" />
</template> <script>
import Icon from '@flouvia/gota/svelte';
</script>
<Icon name="bell" variant="fill" weight="light" /> El componente de Astro se dibuja en el servidor: la página no carga JavaScript. Si usas effect, importa una vez @flouvia/gota/motion.css en tu layout.
---
import Icon from '@flouvia/gota/astro';
---
<Icon name="bell" weight="bold" /> Sin framework
svg() devuelve el SVG completo de un ícono con las opciones que le pidas:
import { svg } from '@flouvia/gota/core';
import { MailIcon } from '@flouvia/gota/icons';
svg(MailIcon, { variant: 'fill', weight: 'bold', enclosure: 'circle' }); Con el sprite (sprite.svg y sprite-fill.svg), un archivo sirve todos los íconos; sprite() arma uno con solo los tuyos.
<svg><use href="sprite.svg#gota-bell" /></svg> Con la fuente, el nombre del ícono es una ligadura. Es variable: el trazo sigue al font-weight, de 300 a 700.
import '@flouvia/gota/font.css';
<i class="gota">bell</i>
<i class="gota gota-fill">bell</i> SwiftUI y Android
Para Xcode, un catálogo de símbolos personalizados: cada ícono en cada peso y escala, y se usa como cualquier símbolo.
Image("bell")
.font(.body.weight(.bold))
.imageScale(.large) Para Android, cada ícono como Vector Drawable, en el ZIP de cada versión.
Agentes de IA
El servidor MCP de Gota busca íconos por significado y devuelve su código. Es público, de solo lectura y no pide credenciales. En Claude Code:
claude mcp add --transport http gota https://gota.flouvia.com/mcp En otro cliente, agrega la URL https://gota.flouvia.com/mcp como servidor HTTP. La misma búsqueda viene en el paquete, en español y en inglés:
import { searchIcons } from '@flouvia/gota/search';
searchIcons('cobrar'); // card, cheque, wallet, invoice… Cómo se dibuja
Las reglas que hacen que mil íconos parezcan de la misma mano:
- Un lienzo de 24 y un trazo de 1.5 con puntas y uniones redondas, en un solo color.
- Keylines: el círculo, el cuadrado, el apaisado y el vertical miden lo justo para que todos pesen igual.
- Esquinas continuas, como las de Apple, nunca un rectángulo con arcos.
- La firma: los contenedores llevan la esquina inferior derecha recta, como la gota del isotipo de Flouvia, y los globos de conversación son la gota misma.
- El relleno se hace con los trazos del contorno: los dos coinciden al píxel.