Guía.

Cómo se usa Gota en cada plataforma, con todas sus opciones. El paquete sale con la primera versión; el servidor para agentes ya funciona.

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 · fill Contorno o relleno.
weight
light · regular · bold · de 0.9 a 2.1 · auto El trazo. Con auto, iguala el peso del texto que lo rodea.
enclosure
circle · square Lo encierra en un círculo o en un cuadrado.
slash
true Lo tacha. Si el ícono tiene su versión tachada dibujada a mano, gana esa.
scale
small · medium · large Su tamaño junto al texto: por omisión mide 1em y baja -0.125em, como una letra.
size
número o medida Un tamaño fijo, en lugar de seguir al texto.
value
de 0 a 1 En el wifi, la batería, el volumen o un medidor: el valor que muestran. Un cambio se anima.
effect · play
auto · hover · once · loop Su gesto propio (la campana suena, el engrane gira) y cuándo se hace.
transition
auto Anima el cambio de ícono, de tachado o de relleno (React, Vue y Svelte).
rtl
true Refleja 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.