Roadmap

Track project feedback and changes over time. Add ideas to FEEDBACK.md, and project releases to CHANGELOG.md.

Add entries to catalyst/FEEDBACK.md using the format: ## Title (YYYY-MM-DD, @author). When ready to act on feedback, create a brief.

Feedback & Ideas

Capture feedback, ideas, and suggestions here. When prioritized, create a brief.

Format: ## Title (YYYY-MM-DD, @author)


Catalyst Stack Issues (2026-01-24, @ai-agent)

Two issues encountered during The Engine Room development that need upstream fixes.

Issue 1: Button — base-ui React 19 Incompatibility

Problem: @base-ui/react/button returns undefined in React 19, causing runtime error:

Element type is invalid: expected a string or a class/function but got: undefined

Workaround: Replaced with @radix-ui/react-slot pattern (standard shadcn approach).

Recommendation: Migrate Button to Radix Slot or wait for base-ui React 19 support.


Issue 2: Title — Default Left Alignment Overrides Parent

Problem: Title component defaults to align: "left", overriding parent's text-center class.

// Expected: centered. Actual: left-aligned.
<Center>
  <Stack className="text-center">
    <Title size="h2">This appears left-aligned</Title>
  </Stack>
</Center>

Root cause: In components/core/title.tsx:

defaultVariants: { align: "left" }  // ← Overrides parent

Workaround: Explicitly pass align="center" to every centered Title.

Recommendation: Add align: "inherit" option (empty string) and make it the default. Components should inherit alignment unless explicitly overridden.


| Issue | Severity | Location | |-------|----------|----------| | base-ui React 19 | 🔴 Breaking | components/ui/button.tsx | | Title default align | 🟡 Annoying | components/core/title.tsx |

<!-- Add new feedback entries here -->