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·fillOutline or fill. - weight
-
light·regular·bold·0.9to2.1·autoThe stroke. Withauto, it matches the weight of the text around it. - enclosure
-
circle·squareEncloses it in a circle or a square. - slash
-
trueSlashes it. If the icon has a hand-drawn slashed version, that one wins. - scale
-
small·medium·largeIts size next to text: by default it measures1emand drops-0.125em, like a letter. - size
- number or length A fixed size, instead of following the text.
- value
-
0to1On wifi, battery, volume or a gauge: the value they show. A change animates. - effect · play
-
auto·hover·once·loopIts own gesture (the bell rings, the gear turns) and when it plays. - transition
-
autoAnimates a change of icon, slash or fill (React, Vue and Svelte). - rtl
-
trueMirrors 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.