Gesso CLI

📄️ Overview

@acromedia/gesso-cli scaffolds prototypes, adds Gesso to existing Next.js projects, gives coding agents versioned design-system information, and checks project health.

📄️ gesso config

The gesso config command is used to create or update the necessary Gesso configuration file for your project. The gesso.config.json file is tailored to different platforms based on initial Gesso project setup.

📄️ Registry authentication

Acromedia packages are served from a private GitLab registry. Authentication is required before pnpm dlx, pnpm install, or other package-resolution commands can download them.

📄️ Create a prototype

Create a standalone Next.js App Router prototype with Gesso already wired.

📄️ Initialize an existing project

Add Gesso and its agent support to an existing Next.js project without editing application entry files.

📄️ Agent command reference

These read-only commands serve versioned Gesso information to coding agents. Run them from an installed project with pnpm gesso. Successful output ends with one next, end with next. Structured lists use TOON (Token-Oriented Object Notation).

📄️ Project health

Inspect a project and print eight setup checks as TOON (Token-Oriented Object Notation):

📄️ Generate Stories

What It Does

📄️ Localize Dependencies

What It Does

📄️ Update CMS Palette

The update-cms-palette command synchronizes color palettes between the Design System (sourced from Figma tokens) and the Content Management System (CMS). This ensures editors can use the same colors in the CMS as defined in the design system, creating a consistent user experience.