Carto-Art separates structure (the MapLibre style) from color (the palette). Mixing them is the easiest way to ship a coherent look.

Built-in styles

const poster = await client.posters.generate({
  location: { lat: 51.5074, lng: -0.1278 },
  style: 'noir',
});

Available styles include minimal, noir, topographic, blueprint, and vintage.

Choosing a palette

Pass a palette slug to override the style's default colors:

const poster = await client.posters.generate({
  location: { lat: 48.8566, lng: 2.3522 },
  style: 'minimal',
  palette: 'sunset',
});

Custom palettes

Provide a palette object with layers keyed by MapLibre layer id:

const poster = await client.posters.generate({
  location: { lat: 35.6762, lng: 139.6503 },
  style: 'minimal',
  palette: {
    background: '#0a0f1a',
    water: '#1c2a42',
    roads: '#c9a962',
    buildings: '#f5f0e8',
  },
});

Performance tip

high_res: true doubles raster time but unlocks print-quality assets. Use it only when you need a poster above 4,000 pixels on its long edge.