@hashintel/ds-components
v0.0.1-c
Published
HASH Component Library built with React, Ark UI, and PandaCSS
Readme
@hashintel/ds-components
React components for HASH's refractive design system, built with TypeScript, Ark UI, and PandaCSS.
LLM-Driven Development
Component development is primarily handled by LLM coding assistants (GitHub Copilot, Claude, etc.) using the CONTRIBUTING.md as instructions.
For LLM Assistants
See CONTRIBUTING.md for complete implementation instructions including:
- Figma design context retrieval via MCP
- Ark UI pattern integration
- Design token mapping
- Component structure and patterns
- Storybook stories creation
For Human Developers
Use LLM assistants to add or update components. Direct manual implementation is only needed for:
- Complex edge cases beyond current LLM capabilities
- Bug fixes requiring deep debugging
- Architectural changes
Quick setup:
- Ensure Figma Desktop app is running with the design file open
- Have Figma MCP Server configured in Figma app
- Have Ark UI MCP Server configured in your User MCP config (not committed to repo)
- Select the component in Figma you want to implement
- Ask your LLM assistant to implement the component
- Review the component in Storybook to verify rendering and behavior match the design
- Make manual adjustments if needed for edge cases or visual refinements
Design System Architecture
Design Tokens: Defined in @hashintel/ds-theme package, synchronized from Figma variables
Token Mapping: figma-to-panda-mapping.json (automatically generated) translates Figma variables to PandaCSS tokens
Styling System: PandaCSS provides type-safe styling with design tokens fully type-checked at compile time. Invalid tokens or outdated token names (from Figma updates or mapper changes) will produce TypeScript errors, ensuring design system consistency.
Component Base: Built on Ark UI for accessibility and behavior patterns
