Colors Website

Static Astro site for https://www.getcolors.ai.

Colors helps agents write complete infrastructure workflows, including the colors.yml configuration and the code that coordinates CLI tools and checks outcomes. Context Skills supply knowledge from verified builds to help tailor the workflow to a team's requirements. A Package Skill bundles executable workflow code and instructions; people and CI runners can execute it without an agent. Current packages focus on OpenTofu and Ansible. Colors workflows can call any DevOps CLI, including Kubernetes tools.

Commands

pnpm install
pnpm dev
pnpm build
pnpm preview
pnpm typecheck        # astro check — CI runs this before it builds an image
pnpm skills:generate  # rebuild pinned agent-skill artifacts and discovery index
pnpm skills:update    # update upstream pins, then rebuild the artifacts and index

Structure

• / is the Colors SDK landing page; src/data/landing.ts also feeds its content-negotiated /index.md twin.
• /featured presents examples of Package Skills.
• /skills is the searchable, PR-curated catalog of Package Skills and Context Skills.
• /{owner}, /{owner}/{repository}, and /{owner}/{repository}/{package-skill} are generated catalog pages.
• recipes/*.yml controls catalog admission. One recipe groups a product's runtime variants; adding one through a PR grants discoverability only.
• Package Skill metadata and instructions come from each recipe's public SKILL.md. Installation counts come from skills.sh at build time. GitHub remains the source and npx skills remains the installer.
• src/pages/blog/rss.xml.ts publishes the live blog feed from src/data/blog.ts.
• public/.well-known/agent-skills/ contains separately generated, content-addressed discovery artifacts. Regenerate it through the scripts.
• Landing and blue catalog OG cards under public/og-*.png are generated by scripts/generate-og-image.py.
• plans/colors-landing-page-export.html is the visual reference for /, not a build input.

To check a link preview before deploying, build against a preview host:

SITE_URL=https://<preview-host> pnpm build

The site uses no CSS framework. Every route uses the landing page's palette, typography, spacing, shared SiteHeader.astro, shared SiteFooter.astro, and favicon.svg mark. Catalog routes share src/layouts/CatalogLayout.astro; /featured preserves the original featured sections and DAG styling.

Slides

/slides lists presentations and is linked from the shared site navigation.

The Marp deck at /slides/introduction/ introduces Colors and closes with the 18 September 2026 Community Town Hall invitation. Its PDF is linked on the first slide and the event page. Source and speaker notes live in slides/introduction.md; slides/colors.css supplies the theme.

The deck at /slides/green-kubernetes/ covers the Kubernetes SDKs, DOKS and Redis Operator in Green, Red and Blue, with live deployment evidence. Its source and speaker notes live in slides/green-kubernetes.md; the URL stays stable.

Run pnpm slides:build after editing the source or theme, then commit the generated HTML and PDF under public/slides/<deck>/. To rebuild only the Kubernetes deck, run pnpm slides:build green-kubernetes. The command needs a local Chrome or Chromium installation. Set CHROME_PATH to its executable if autodetection fails. It embeds the site's fonts and the generated registration QR code, so the PDF and HTML do not depend on a font service. SITE_URL controls the HTML canonical and sharing URLs. Normal pnpm build copies the committed deck without requiring a browser in the production build.