Identities and custom assets

Every generator accepts an identity object.

Presets

• starter is the complete neutral default.
• template is a rigorous identity-construction blueprint.
• gt resolves the bundled General Translation identity and logo family.
• ramp, mintlify, tailwind, viteplus, cloudflare, and stripe resolve audited reference systems and their local logo assets.
• custom avoids inheriting a preset logo and creates a monogram when no logo is supplied.

Fetch /api/identities at runtime instead of hard-coding the list. Each record includes foundations, strategy, graphic-system rules, application definitions, proof references, and local asset IDs.

Identity fields

Fields override the selected preset. Omitted values inherit from the preset.

Convert a logo to a data URL

On macOS or Linux:

MIME=image/png
LOGO_DATA="data:$MIME;base64,$(base64 < logo.png | tr -d '\n')"

Then construct the request with jq so shell escaping is handled safely:

jq -n --arg logo "$LOGO_DATA" '{
  kind: "background",
  identity: {
    preset: "custom",
    name: "Acme",
    shortName: "AC",
    website: "acme.test",
    ink: "#111111",
    paper: "#FFFFFF",
    logoDataUrl: $logo
  },
  settings: {
    width: 1200,
    height: 630,
    style: "gradient",
    colorA: "#FFFFFF",
    colorB: "#D9FF63"
  },
  output: "raw"
}' > request.json

Supported custom image data includes PNG, JPEG, WebP, GIF, and SVG. Remote URLs are rejected; download and authorize the asset before converting it.

Background and partner images

Templates additionally support backgroundImageDataUrl and partnerLogoDataUrl. Use partnerId only for asset IDs returned by /api/identities for the selected preset.

The API embeds accepted assets into the returned SVG so it remains portable.

Reference sources and trademark boundary

The reference identities were studied from primary brand sources current in July 2026:

• Ramp press kit
• Mintlify documentation appearance guide and design practice
• Tailwind CSS brand assets
• Vite+ product site
• Cloudflare press kit and logo guidance
• Stripe newsroom and logo kit

These systems are included for design study and interoperability. Brand names, marks, and source assets remain the property of their respective owners. Glyphfield’s MIT license applies to the software and original templates; it does not grant trademark rights or imply endorsement.

Reference identities also bundle the font files needed to render their Display, Body, Accent, and Code roles without falling back to Glyphfield's interface typeface. Those files retain their original licenses and are not relicensed by Glyphfield's MIT license. The bundled role map and redistribution notice live in public/fonts/brands/README.md.