Catalogs

Why it existsCopy Anchor Link

Data, not logic — but shared data, because the alternative is what already happened: two hand-maintained copies that drifted. Spunto Lite's copy was missing java, kubectl-helm-minikube and google-cloud-cli, and described common-utils as installing Oh My Zsh at a time when the image recipe explicitly passes installOhMyZsh: false. Nobody decided either of those; they are the shape of a catalog nobody owns.

The catalogs are also load-bearing for the generators: buildImageScript in ./script resolves a selected feature id through AVAILABLE_FEATURES to find its OCI ref, its default options or its local script.

import { AVAILABLE_IMAGES, AVAILABLE_FEATURES, SUGGESTED_EXTENSIONS } from "@spunto/build/catalogs"

APICopy Anchor Link

DevImage and AVAILABLE_IMAGESCopy Anchor Link

type DevImage = { id: string; label: string; image: string; description: string }
const AVAILABLE_IMAGES: DevImage[]

The base images a project can start from:

DevFeature, DevFeatureOption and AVAILABLE_FEATURESCopy Anchor Link

type DevFeatureOption = { name: string; default: string; description: string }
const AVAILABLE_FEATURES: DevFeature[]

// A feature picker with option inputs
for (const f of AVAILABLE_FEATURES) {
  renderFeature(f.label, f.description, f.options ?? [])
}

// Look up what a stored selection means
const node = AVAILABLE_FEATURES.find((f) => f.id === "node")
node?.options?.[0] // → { name: "version", default: "lts", description: "Node.js version (lts, 20, 22, etc.)" }

SUGGESTED_EXTENSIONSCopy Anchor Link

const SUGGESTED_EXTENSIONS: ExtensionSuggestion[]

The default state of an extension picker, shown before anyone types a query: esbenp.prettier-vscode, dbaeumer.vscode-eslint, ms-python.python, golang.go, rust-lang.rust-analyzer, bradlc.vscode-tailwindcss, eamodio.gitlens, ms-azuretools.vscode-docker.

Entries carry id, label and publisher only — no registry URLs. The catalog is registry-agnostic: attach links for whichever registry is active with withRegistryUrls from ./extensions.

import { parseGallery, withRegistryUrls } from "@spunto/build/extensions"

const defaults = withRegistryUrls(parseGallery(org.extensionsGallery), SUGGESTED_EXTENSIONS)