mintlify

[github]

the leaf within a leaf, in mint green, glinting now and then

companies 56×28 30 fps in colour or one ink 6.9 kB [report a bug]

use it

html

<script type="module" src="https://ascii.rest/ascii.js"></script>

<ascii-art piece="mintlify" options='{"shine":5}'></ascii-art>

No install and no build step. ascii.js defines the <ascii-art> tag, loads the piece from ascii.rest, plays it while it is on screen, and holds the first frame for anyone who prefers reduced motion. Add mono, <ascii-art piece="mintlify" mono>, for one ink.

react

// npm install ascii.rest
import { Ascii } from "ascii.rest/react";
import { mintlify } from "ascii.rest/pieces";

<Ascii piece={mintlify} options={{"shine":5}} />

A client component, so it works in the Next.js app router as it is. Pass the name instead, piece="mintlify", to fetch the piece only when it mounts. Add mono for one ink.

astro

---
// npm install ascii.rest
import Ascii from "ascii.rest/astro";
---

<Ascii piece="mintlify" options={{"shine":5}} />

Renders the first frame on the server, so the page is whole before any script runs, then plays the piece once it loads. Add mono for one ink.

typescript

// npm install ascii.rest
import { mount } from "ascii.rest";
import { mintlify } from "ascii.rest/pieces";

const el = document.querySelector<HTMLCanvasElement>("canvas")!;
const stop = mount(el, mintlify, {"shine":5});

mount plays a piece in a <pre>, or on a <canvas> for the coloured ones, and returns a function that stops it. Every piece, option and frame is typed. Mount it in a <pre> for one ink.

terminal

npx ascii.rest mintlify

Plays it in your terminal, in colour, until you press a key. Add --mono for the terminal's own colour. Add --light for a light terminal. Add --seconds 5 to stop it on its own; npx ascii.rest list shows every piece. In a CLI of your own, play("mintlify", { seconds: 2 }) from ascii.rest/terminal shows it as a splash screen.

readme

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://ascii.rest/svg/mintlify.dark.svg">
  <img alt="mintlify" src="https://ascii.rest/svg/mintlify.svg" width="280">
</picture>
mintlify, as a light README shows it
light, mintlify.svg
mintlify, as a dark README shows it
dark, mintlify.dark.svg

An animated SVG that needs no script, so it plays in a GitHub README, which runs none. GitHub shows the dark one in its dark theme. It holds still for anyone who prefers reduced motion.

mintlify.ts

[js] [github] 
/*
 * mintlify: the Mintlify logo, a leaf on a stem cut out of a green leaf, with
 * a glint crossing it every few seconds.
 *
 * Drawn from Simple Icons' mintlify.svg (CC0): each cell holds the character
 * whose shape best matches the logo's edge through it, and 8 where the logo is
 * solid. On a canvas it takes the logo's colour, and a deeper shade of it on a
 * light page, where it would fade into it; in a <pre> it is one ink, from the
 * same drawing. The logo is a trademark of its owner, shown here to name the
 * company.
 */
import type { Frame, Meta } from "../types.ts";

export interface MintlifyOptions {
  [key: string]: unknown;
  /** Seconds between glints; 0 keeps the logo still. */
  shine: number;
}

export const meta = {
  name: "mintlify",
  category: "companies",
  note: "the leaf within a leaf, in mint green, glinting now and then",
  cols: 56,
  rows: 28,
  fps: 30,
  options: { shine: 5 },
  // The logo's colour for a light page, then for a dark one; each as drawn, then twice lighter for the glint.
  palette: [
    "#12a670", "#65c5a2", "#b8e4d4", "#18e299", "#69ecbd", "#baf6e0",
  ],
} satisfies Meta<MintlifyOptions>;

// In a <pre>, in the page's own colour.
const MONO = String.raw`

                          ._ppp88888888888888888888888
                       _pp8888888888888888888888888888
                     _p8888888888888888888888888888888
                   _p888888888888888888888888888888888
                 _p88888888888888888888888888888888888
               _p8888888888888888888888888888888888888
             _p888888888888888888888888888888888888888
           _p888"        '""Y8888888888888888888888888
         _p88888              '"8888888888888888888888
       _p888888b                 'Y8888888888888888888
     _p888888888                   '888888888888888888
    _88888888888,                    "888888888888888P
   )888888888888p                     "88888888888888'
  .88888888888888(                     O888888888888"
  q888888888888888p                    '88888888888"
  88888888888888888"                    888888888P'
  888888888888888"                      d8888888"
  8888888888888"      _q_,              888888"
  d8888888888"      _p8888qq__,        _8888"
  '88888888"      _p8888888888888888888888"
   "88888"      _p8888888888888888888888"
    "88"      _p8888888888888888888888"
            _p8888888888888888888888"
          _p888888888888888888888P"
          "88888888888888888888"'
             ""Y8888888888P""

`;

// On a canvas, and the colour of each cell: an index into the logo's colours.
const ART = String.raw`

                          ._ppp88888888888888888888888
                       _pp8888888888888888888888888888
                     _p8888888888888888888888888888888
                   _p888888888888888888888888888888888
                 _p88888888888888888888888888888888888
               _p8888888888888888888888888888888888888
             _p888888888888888888888888888888888888888
           _p888"        '""Y8888888888888888888888888
         _p88888              '"8888888888888888888888
       _p888888b                 'Y8888888888888888888
     _p888888888                   '888888888888888888
    _88888888888,                    "888888888888888P
   )888888888888p                     "88888888888888'
  .88888888888888(                     O888888888888"
  q888888888888888p                    '88888888888"
  88888888888888888"                    888888888P'
  888888888888888"                      d8888888"
  8888888888888"      _q_,              888888"
  d8888888888"      _p8888qq__,        _8888"
  '88888888"      _p8888888888888888888888"
   "88888"      _p8888888888888888888888"
    "88"      _p8888888888888888888888"
            _p8888888888888888888888"
          _p888888888888888888888P"
          "88888888888888888888"'
             ""Y8888888888P""

`;
const INK = String.raw`

                          0000000000000000000000000000
                       0000000000000000000000000000000
                     000000000000000000000000000000000
                   00000000000000000000000000000000000
                 0000000000000000000000000000000000000
               000000000000000000000000000000000000000
             00000000000000000000000000000000000000000
           000000        00000000000000000000000000000
         0000000              000000000000000000000000
       000000000                 000000000000000000000
     00000000000                   0000000000000000000
    0000000000000                    00000000000000000
   00000000000000                     0000000000000000
  0000000000000000                     00000000000000
  00000000000000000                    0000000000000
  000000000000000000                    00000000000
  0000000000000000                      000000000
  00000000000000      0000              0000000
  000000000000      00000000000        000000
  0000000000      0000000000000000000000000
   0000000      0000000000000000000000000
    0000      0000000000000000000000000
            0000000000000000000000000
          0000000000000000000000000
          00000000000000000000000
             0000000000000000

`;

const START = 0.5; // seconds before the first glint
const PASS = 2; // seconds a glint takes to cross
const HALF = 5; // half its width, in cells
const LEAN = 0.9; // cells it shifts left a row down, so it leans like a slash
const SOLID = "8dbqpPYOo0"; // what the glint turns to slashes; thin edges keep their shape

const lines = (art: string) => art.slice(1, -1).split("\n").map((line) => line.padEnd(meta.cols));

export default function mintlify({ shine = meta.options.shine }: Partial<MintlifyOptions> = {}): Frame {
  const { cols, rows } = meta;
  const mono = lines(MONO), art = lines(ART), ink = lines(INK);
  const n = meta.palette.length / 6;
  const every = shine > 0 ? Math.max(shine, PASS + 0.5) : 0;
  // The glint crosses the logo's ink, edge to edge, rather than the whole frame.
  let lo = Infinity, hi = -Infinity;
  for (const pic of [mono, art])
    pic.forEach((line, y) => {
      for (let x = 0; x < cols; x++) if (line[x] !== " ") (lo = Math.min(lo, x + LEAN * y)), (hi = Math.max(hi, x + LEAN * y));
    });
  const span = hi - lo + 2 * HALF;

  return (t, { paper = false, color } = {}) => {
    const pic = color ? art : mono;
    const since = t - START;
    const at = every && since >= 0 ? lo - HALF + (span * (since % every)) / PASS : -Infinity;
    const out: string[] = [];
    for (let y = 0; y < rows; y++) {
      let line = "";
      for (let x = 0; x < cols; x++) {
        let ch = pic[y][x];
        if (ch !== " ") {
          const d = Math.abs(x + LEAN * y - at);
          let k = d < HALF ? 1 - d / HALF : 0;
          k = k * k * (3 - 2 * k);
          if (k > 0.55 && SOLID.includes(ch)) ch = "/";
          if (color) color[y * cols + x] = (paper ? 0 : 3 * n) + (k > 0.6 ? 2 : k > 0.25 ? 1 : 0) * n + parseInt(ink[y][x], 36);
        }
        line += ch;
      }
      out.push(line);
    }
    return out.join("\n");
  };
}