Skip to main content

AptlantisLogos Overview

AptlantisLogos is a local asset pipeline that turns source PNG logos into production-ready SVG, PNG, and ICO derivatives, extracts a 16-color palette from each, and renders an HTML atlas to preview the whole set at once. It currently holds 62 language/technology logos (Python, Rust, Go, Kubernetes, Terraform, and dozens more) — this is the source of the small tech-badge icons used elsewhere across Aptlantis sites and documentation.

:::info Status Paused at 95% complete. The manifest classifies it stage = production / stability = stable, but that's a metadata classification, not a release-readiness claim — build, test, and artifact generation were not re-executed during the last governance pass. :::

Who it's for​

A single operator producing consistent logo/icon assets for Aptlantis deployments and documentation — not a general-purpose logo generator or a service other people run.

The core concept​

The pipeline is four manual steps, each a standalone script rather than one orchestrated command:

  1. Source a PNG (e.g. a DALL·E output) into png/.
  2. Extract a 16-color palette with ImageMagick, then turn the hex values into a themes/<name>.toml file (primary/secondary/surface/accent/text roles).
  3. Convert to SVG and ICO with Convert-to-SVG.py (embed or trace mode) and Convert-to-ICO.py.
  4. Regenerate the atlas with generate_atlas.py — an HTML page for visually reviewing every logo, palette, and derivative at once.
png/           <-- 124 source raster files
svg/           <-- 62 SVG derivatives
themes/        <-- one .toml palette file per logo (primary/secondary/surface/accent/text)
palettes/      <-- raw extracted palette .txt files
logos.json     <-- semantic metadata: label, site, description per logo
palette-atlas.html  <-- generated preview atlas (self-contained, image-heavy)

logos.json is the semantic layer — each logo entry carries a human label, source site URL, and short description (e.g. "bioconductor": {"label": "Bioconductor", "site": "https://www.bioconductor.org/", "description": "Open-source R-based bioinformatics platform"}), which is what lets consuming sites show meaningful captions rather than bare filenames.