Skip to main content

Documentation Index

Fetch the complete documentation index at: https://logo-soup.sanity.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Install

npm install @sanity-labs/logo-soup

Pick your framework

The fastest way is the pre-built <LogoSoup> component:
import { LogoSoup } from "@sanity-labs/logo-soup/react";

function LogoStrip() {
  return (
    <LogoSoup
      logos={[
        { src: "/logos/acme.svg", alt: "Acme Corp" },
        { src: "/logos/globex.svg", alt: "Globex" },
        { src: "/logos/initech.svg", alt: "Initech" },
      ]}
    />
  );
}
That’s it. Logo Soup analyzes each image and renders them visually balanced.For custom layouts, use the useLogoSoup hook instead — see the React guide.

Logos format

Logos can be plain URL strings or objects with src and optional alt text:
// Plain strings
const logos = ["/logos/acme.svg", "/logos/globex.svg"];

// Objects with alt text (recommended for accessibility)
const logos = [
  { src: "/logos/acme.svg", alt: "Acme Corp" },
  { src: "/logos/globex.svg", alt: "Globex" },
];

// You can mix both
const logos = [
  "/logos/acme.svg",
  { src: "/logos/globex.svg", alt: "Globex" },
];

Next steps

Options reference

Tune base size, density, scale factor, alignment, and more.

How it works

Content detection, normalization math, and irradiation compensation explained.

Framework guides

Deep dives for React, Vue, Svelte, Solid, Angular, and vanilla JS.

Core engine API

Use the engine directly for unsupported frameworks or advanced use cases.