{
 "slug": "squishmoji",
 "name": "Squishmoji",
 "author": "Space UI",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "React and TypeScript library that generates deterministic, animated squishy SVG avatars and emojis from a seed string.",
 "category": {
  "slug": "avatars",
  "name": "Avatars and placeholders"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/usespaceui.png",
 "logo_letter": "S",
 "links": {
  "repo": "https://github.com/usespaceui/squishmoji",
  "website": null,
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/squishmoji/demo.jpg",
  "alt": "Twelve avatars made from twelve first names with shape, expression and background picked from each name, and one name drawn as a cat with seven different expressions.",
  "caption": "Made by AgentGid with @usespaceui/squishmoji 0.1.0 (with @usespaceui/gradients 0.1.4). MIT license; the names are made up."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Free and open source under the MIT license.",
   "source": {
    "label": "github.com/usespaceui/squishmoji",
    "url": "https://github.com/usespaceui/squishmoji"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "MIT — Free for personal and commercial projects.",
   "note": "Free for personal and commercial projects under MIT.",
   "source": {
    "label": "github.com/usespaceui/squishmoji",
    "url": "https://github.com/usespaceui/squishmoji"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install @usespaceui/squishmoji. No key or account is needed.",
   "source": {
    "label": "github.com/usespaceui/squishmoji",
    "url": "https://github.com/usespaceui/squishmoji"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE",
  "summary": "Free to use in personal and paid products, and you may change and share the code. When you ship copies of the code, keep its copyright and license notice with them.",
  "pages_read": 2,
  "rules": [
   "Keep the MIT license file and copyright notice with any copies or substantial portions you ship.",
   "Install via npm (@usespaceui/squishmoji) and generate avatars locally; no remote images or API calls are needed.",
   "Use createAvatar for static SVG in Node, SSR or vanilla JS; use the /react entry only with React 18+."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "MIT — Free for personal and commercial projects.",
    "source": {
     "label": "github.com/usespaceui/squishmoji",
     "url": "https://github.com/usespaceui/squishmoji"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE"
    },
    "note": "You may copy, publish and sell copies of the code if the MIT notice goes with them."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-04",
  "commercial_use_page": "https://agentgid.com/assets/squishmoji/commercial-use/"
 },
 "overview": {
  "heading": "Squishmoji: cute animated avatars made from any name",
  "body": "Squishmoji is a free code library that draws a small squishy character with eyes from any text, such as a user name. The same name always gives the same character, so every user gets a stable picture without uploading a photo. The pictures are SVG drawings made in the browser or on your server, can breathe and blink, and work best in React apps."
 },
 "uses": [
  {
   "title": "Profile pictures without uploads",
   "text": "Give every account its own picture from the user name or ID. It stays the same on every visit, and nobody has to upload a photo.",
   "idea": false,
   "image": "https://agentgid.com/assets/squishmoji/use-signups.jpg"
  },
  {
   "title": "Avatars made on your server",
   "text": "Make the picture as a ready file on the server, for an email, a server-rendered page or a link preview. No React is needed for this.",
   "idea": false,
   "image": null
  },
  {
   "title": "A mascot that reacts",
   "text": "Put a small character on a login screen or an empty page. It can look surprised when the pointer is over it and change its face when clicked.",
   "idea": false,
   "image": null
  },
  {
   "title": "Moods and reactions in chat",
   "text": "Show a mood next to a message or a status, such as happy, sleepy or angry. The same character keeps its colors while its eyes change.",
   "idea": false,
   "image": null
  },
  {
   "title": "Faces for AI helpers and bots",
   "text": "Give each AI assistant or bot in your app its own face, for example with the bot or alien shape, so people can tell them apart.",
   "idea": true,
   "image": null
  },
  {
   "title": "Placeholder people in mockups",
   "text": "Fill demo lists, team pages and screenshots with friendly faces instead of stock photos of real people.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Install @usespaceui/squishmoji at version 0.1.0 and show a Squishmoji avatar for each user, using the user ID as the seed, with animation turned off when the user prefers reduced motion.",
  "install": "npm install @usespaceui/squishmoji",
  "install_note": "It pulls in its color helper by itself; only the React part needs React 18 or newer.",
  "code": [
   {
    "tab": "React",
    "intro": "In a React app, put the component where the avatar should appear and pass the user name or ID as the seed.",
    "source": "import { Squishmoji } from '@usespaceui/squishmoji/react'\n\nexport default function UserProfile() {\n  return (\n    <Squishmoji\n      seed=\"space-explorer\"\n      shape=\"cat\"\n      expression=\"loving\"\n      size={120}\n      className=\"rounded-full\"\n      animate\n      animOnClick\n      animOnHover\n    />\n  )\n}"
   },
   {
    "tab": "Without React",
    "intro": "Without React, or on the server, call createAvatar to get the finished drawing as text.",
    "source": "import { createAvatar, resolveLayout, renderLayout, SquishOutputFormat } from '@usespaceui/squishmoji'\n\n// 1. Generate raw SVG markup (default)\nconst svg = createAvatar('space-explorer', {\n  shape: 'ufo',\n  expression: 'amazed',\n  size: 256,\n  backgroundStyle: 'solid',\n})"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "import { Squishmoji } from '@usespaceui/squishmoji'",
   "fix": "import { Squishmoji } from '@usespaceui/squishmoji/react' (the root import only has createAvatar and helpers)",
   "why": "The React component lives in the /react entry; in 0.1.0 the root file exports no Squishmoji or Avatar.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Calling createAvatar() or <Squishmoji /> without a seed, or with a display name that users can change",
   "fix": "Always pass a stable seed such as the user ID",
   "why": "With no seed every user gets the default \"Space UI\" avatar, and a renamed user would get a new picture.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Expecting different seeds to give different shapes and faces with default options",
   "fix": "Pass shape: 'all', expression: 'all' and backgroundStyle: 'all' for a full mix, or set them on purpose",
   "why": "By default only the colors follow the seed; the shape stays circle and the face neutral (our sign-up demo with a fixed shape shows only color changes).",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Loading node_modules/@usespaceui/squishmoji/dist/index.mjs in a plain <script type=\"module\"> page",
   "fix": "Use a bundler (Vite, Next) or add an import map entry for @usespaceui/gradients",
   "why": "The library imports @usespaceui/gradients by its bare name; our no-bundler demo page only loaded after an import map pointed that name at the file.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Using the animated React component for still images in emails or previews",
   "fix": "Use createAvatar, frozenAt or animate={false} for still output",
   "why": "The component animates by default (breathing, gaze drift, blinking).",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install @usespaceui/squishmoji",
  "repo": "https://github.com/usespaceui/squishmoji",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Avatars: Squishmoji by Space UI (MIT)",
  "rules_text": "- Squishmoji (Avatars and placeholders). React and TypeScript library that generates deterministic, animated squishy SVG avatars and emojis from a seed string. Price: free; commercial use OK; no credit needed.\n  Connect: npm @usespaceui/squishmoji.\n  Rule: Keep the MIT license file and copyright notice with any copies or substantial portions you ship.\n  Rule: Install via npm (@usespaceui/squishmoji) and generate avatars locally; no remote images or API calls are needed.\n  Rule: Use createAvatar for static SVG in Node, SSR or vanilla JS; use the /react entry only with React 18+.\n  License: https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE (checked 2026-11-04; details: https://agentgid.com/assets/squishmoji/)",
  "agent_md": "https://agentgid.com/assets/squishmoji/agent.md",
  "card_json": "https://agentgid.com/assets/squishmoji/card.json"
 },
 "popularity": {
  "gid_score": 29,
  "stars": 2,
  "downloads_7d": 17697,
  "downloads_7d_label": "17.7K",
  "downloads_change_4w_pct": 310.3,
  "eco": "npm",
  "package": "@usespaceui/squishmoji",
  "repo": "usespaceui/squishmoji",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": true,
  "series": {
   "downloads_weekly": [
    [
     "2026-08-31",
     172
    ],
    [
     "2026-09-07",
     78
    ],
    [
     "2026-09-14",
     299
    ],
    [
     "2026-09-21",
     297
    ],
    [
     "2026-09-28",
     1131
    ],
    [
     "2026-10-05",
     1182
    ],
    [
     "2026-10-12",
     7305
    ],
    [
     "2026-10-19",
     4830
    ],
    [
     "2026-10-26",
     5608
    ],
    [
     "2026-11-02",
     16771
    ],
    [
     "2026-11-09",
     13470
    ]
   ],
   "stars": []
  },
  "stars_flat_since": "2026-11-07",
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "squishmoji",
   "name": "Squishmoji",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "dicebear",
   "name": "DiceBear",
   "why": "Pick DiceBear when you want many different avatar styles or a ready image link from a free web service instead of a code library.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "API, npm"
  },
  {
   "slug": "boring-avatars",
   "name": "Boring Avatars",
   "why": "Pick Boring Avatars for calmer, abstract shapes and colors in React instead of characters with faces.",
   "current": false,
   "price": "Free tier",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "avvvatars",
   "name": "Avvvatars",
   "why": "Pick Avvvatars when you want simple placeholders with initials or shapes made from a name.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "outpace-avatars",
   "name": "@outpacelabs/avatars",
   "why": "Free open-source React component that renders deterministic generative mesh-gradient or dither avatars on a canvas from any seed.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "open-source-avatars",
   "name": "Open Source Avatars",
   "why": "Curated registry of free 3D VRM avatars (rigged characters for web 3D, VR, games) with direct download links; CC0.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  }
 ],
 "faq": [
  {
   "q": "Will a user get the same avatar every time?",
   "a": "Yes. The same seed, for example a user ID, with the same options always gives the same shape, colors and outline."
  },
  {
   "q": "How many looks are there?",
   "a": "21 body shapes (from circle to cat, ghost, bot and alien), 22 eye expressions and 6 background styles; pass \"all\" to let the seed choose."
  },
  {
   "q": "Do I need React?",
   "a": "Only for the ready-made animated component, which needs React 18 or newer. The createAvatar function works without React, also on a server."
  },
  {
   "q": "Can I get a still image instead of an animation?",
   "a": "Yes. Set animate to false, freeze the animation at a moment with frozenAt, or use createAvatar for a still drawing."
  },
  {
   "q": "Can I use it in a paid app?",
   "a": "Yes. It is MIT licensed and free for personal and commercial projects."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.1.0",
  "last_release": "2026-09-05",
  "last_commit": "2026-09-07",
  "runtime": "React 18+ for the /react entry only; the core import (createAvatar) needs no React. Pulls in @usespaceui/gradients ^0.1.4 by itself.",
  "key_needed": false
 },
 "good_to_know": [
  "Only one version, 0.1.0, has been released so far. Pin that exact version, because early versions can change without warning.",
  "The ready-made component needs React 18 or newer. In other setups you use the plain createAvatar function instead.",
  "Avatars move by default: they breathe, look around and blink. Turn this off for still pictures or for people who prefer less motion.",
  "Everything is drawn on your side. No account, no key and no outside image service is needed."
 ],
 "stack_snippets": [],
 "claims": [
  "100% deterministic: the same seed and options always give the same picture"
 ],
 "checked": {
  "license_read": "2026-11-04",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "github.com/usespaceui/squishmoji",
    "url": "https://github.com/usespaceui/squishmoji"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE"
   },
   {
    "label": "npm: @usespaceui/squishmoji",
    "url": "https://registry.npmjs.org/@usespaceui/squishmoji"
   },
   {
    "label": "npm: @usespaceui/gradients",
    "url": "https://registry.npmjs.org/@usespaceui/gradients"
   },
   {
    "label": "spaceui.one/tools/avatars",
    "url": "https://www.spaceui.one/tools/avatars?type=squishmoji"
   },
   {
    "label": "squishmoji.spaceui.one",
    "url": "https://squishmoji.spaceui.one"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/squishmoji/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
