Guide.

How to use Gota on every platform, with every option. The package ships with the first release; the server for agents already works.

Introduction

Gota is Flouvia’s icon library: icons drawn by hand on a 24 grid, with continuous corners and a single stroke, in outline and fill, and at any weight from light to bold. Each icon is a module: your app ships only the ones it imports.

Today there are over a thousand icons, and the first release ships with 10,000. Until then, this guide describes the package as it will be published.

Installation

Gota arrives on npm with its first release, as @flouvia/gota, under the MIT license. Every release also comes with a ZIP of the SVGs, the Android Vector Drawables, the Xcode symbols and the font.

For design, a library for Figma, with every icon as a component and its style and weight as properties, arrives on Figma Community with the same release.

Meanwhile you can already use it with your AI agent: its MCP server is public (see AI agents).

React

Import the icons each page uses. Each component carries only its own icon’s data.

import { BellIcon, MailIcon } from '@flouvia/gota/react/icons';

<MailIcon />
<BellIcon variant="fill" weight="light" scale="large" />
<BellIcon slash />

When the name arrives at runtime, Icon takes any icon in the set by its name:

import { Icon } from '@flouvia/gota/react';

<Icon name="bell" />

With IconBase, one spot can change icons and animate the change: menu and close morph, a badge draws itself in and the fill rises like a liquid.

import { IconBase } from '@flouvia/gota/react';
import { CloseIcon, MenuIcon } from '@flouvia/gota/icons';

<IconBase icon={open ? CloseIcon : MenuIcon} transition="auto" />

Props

The same in React, Vue, Svelte and Astro.

variant
outline · fill Outline or fill.
weight
light · regular · bold · 0.9 to 2.1 · auto The stroke. With auto, it matches the weight of the text around it.
enclosure
circle · square Encloses it in a circle or a square.
slash
true Slashes it. If the icon has a hand-drawn slashed version, that one wins.
scale
small · medium · large Its size next to text: by default it measures 1em and drops -0.125em, like a letter.
size
number or length A fixed size, instead of following the text.
value
0 to 1 On wifi, battery, volume or a gauge: the value they show. A change animates.
effect · play
auto · hover · once · loop Its own gesture (the bell rings, the gear turns) and when it plays.
transition
auto Animates a change of icon, slash or fill (React, Vue and Svelte).
rtl
true Mirrors directional icons in right-to-left languages.
aria-label
text With it, the icon is announced; without it, it is decorative and hidden from screen readers.

Vue, Svelte and 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" />

The Astro component renders on the server: the page loads no JavaScript. If you use effect, import @flouvia/gota/motion.css once in your layout.

---
import Icon from '@flouvia/gota/astro';
---

<Icon name="bell" weight="bold" />

Without a framework

svg() returns an icon’s full SVG with the options you ask for:

import { svg } from '@flouvia/gota/core';
import { MailIcon } from '@flouvia/gota/icons';

svg(MailIcon, { variant: 'fill', weight: 'bold', enclosure: 'circle' });

With the sprite (sprite.svg and sprite-fill.svg), one file serves every icon; sprite() builds one with only yours.

<svg><use href="sprite.svg#gota-bell" /></svg>

With the font, the icon’s name is a ligature. It is variable: the stroke follows font-weight, from 300 to 700.

import '@flouvia/gota/font.css';

<i class="gota">bell</i>
<i class="gota gota-fill">bell</i>

SwiftUI and Android

For Xcode, a catalog of custom symbols: every icon in every weight and scale, used like any symbol.

Image("bell")
  .font(.body.weight(.bold))
  .imageScale(.large)

For Android, every icon as a Vector Drawable, in each release’s ZIP.

AI agents

Gota’s MCP server finds icons by meaning and returns their code. It is public, read-only and needs no credentials. In Claude Code:

claude mcp add --transport http gota https://gota.flouvia.com/mcp

In another client, add the URL https://gota.flouvia.com/mcp as an HTTP server. The same search comes in the package, in English and Spanish:

import { searchIcons } from '@flouvia/gota/search';

searchIcons('cobrar'); // card, cheque, wallet, invoice…

How it is drawn

The rules that make a thousand icons look drawn by the same hand:

  • A 24 canvas and a 1.5 stroke with round ends and joins, in a single color.
  • Keylines: the circle, the square, the landscape and the portrait shapes are sized so they all carry the same weight.
  • Continuous corners, like Apple’s, never a rectangle with arcs.
  • The signature: containers keep a square bottom-right corner, like the drop in Flouvia’s logomark, and speech bubbles are the drop itself.
  • The fill is made from the outline’s own strokes: the two match to the pixel.