Problem
The Quick Start configuration and its consumption examples still disagree in README.md at 94bf4d8.
The configuration defines coral.100, mint.100, and indigo.100 palette entries, plus spacing.custom.size.1 through 4. However, the example consumes:
@import "cssforge.output.css" layer(cssforge);
.button {
background-color: var(--color-primary-500);
padding: var(--size-2) var(--size-4);
}
The generated spacing declarations use --spacing-size-*, and the configuration has no primary.500 token. The TypeScript usage comment likewise references cssForge.colors.palette.basic.white, which is not produced by this configuration. The CSS import filename also differs from the CLI's documented default ./.cssforge/output.css.
Expected behavior
A consumer should be able to follow the Quick Start from installation through generation and consumption without inventing missing tokens, renaming output files, or correcting generated-object paths.
For example, with the documented palette and spacing configuration, the CSS consumption should use:
/* Relative to a consumer stylesheet placed at the project root. */
@import "./.cssforge/output.css" layer(cssforge);
.button {
background-color: var(--palette-coral-100);
padding: var(--spacing-size-2) var(--spacing-size-4);
}
Derive the TypeScript consumption example from the actual generated module rather than guessing its object shape.
Acceptance criteria
Relationship to existing work
#21 already added generated-documentation synchronization/enforcement. This issue is a remaining semantic correctness gap in the Quick Start, not a request to rebuild or replace that pipeline. Installation and import-specifier changes belong to #22.
Problem
The Quick Start configuration and its consumption examples still disagree in README.md at 94bf4d8.
The configuration defines
coral.100,mint.100, andindigo.100palette entries, plusspacing.custom.size.1through4. However, the example consumes:The generated spacing declarations use
--spacing-size-*, and the configuration has noprimary.500token. The TypeScript usage comment likewise referencescssForge.colors.palette.basic.white, which is not produced by this configuration. The CSS import filename also differs from the CLI's documented default./.cssforge/output.css.Expected behavior
A consumer should be able to follow the Quick Start from installation through generation and consumption without inventing missing tokens, renaming output files, or correcting generated-object paths.
For example, with the documented palette and spacing configuration, the CSS consumption should use:
Derive the TypeScript consumption example from the actual generated module rather than guessing its object shape.
Acceptance criteria
Relationship to existing work
#21 already added generated-documentation synchronization/enforcement. This issue is a remaining semantic correctness gap in the Quick Start, not a request to rebuild or replace that pipeline. Installation and import-specifier changes belong to #22.