core-components

Governs usage of the iWana neXt UI component system and design tokens for web frontend development.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/SleyiW/iWana-neXt --skill core-components-sleyiw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-components
Source: https://github.com/SleyiW/iWana-neXt/tree/main/.agents/skills/core-components
Command: npx skills add https://github.com/SleyiW/iWana-neXt --skill core-components-sleyiw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Frontend teams often build ad hoc UI with hardcoded styles, inconsistent spacing, and duplicated primitives. This Skill enforces a shared component system and semantic design tokens so web UI stays consistent, accessible, and maintainable across the iWana neXt project. ## Core Features & Use Cases - Component inventory governance: Lists which @iwana/ui components (Button, Input, Card, Badge, OtpInput, ThemeProvider, ThemeToggle) are actually implemented versus roadmap items, preventing imports of nonexistent components. - Design token rules: Defines semantic token categories for spacing, typography, color, and radius built on Tailwind 4 CSS-first configuration with shadcn/ui and Radix Primitives. - Patterns and anti-patterns: Provides ready-to-use TSX patterns for sections, forms, empty states, and primary actions, plus explicit anti-patterns such as hardcoded inline styles and React Native imports. - Use Case: When building a new customer summary screen, an agent uses this Skill to compose Section, Stack, Heading, and Text primitives with semantic tokens instead of inventing one-off styled divs. ## Quick Start Use the core-components skill to build a form section for the customer page using only implemented @iwana/ui components and semantic design tokens.

Frequently Asked Questions about core-components

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build consistent web UI with a shared component system?

Prefer components from the shared @iwana/ui package over new HTML wrappers, and use semantic tokens for color, spacing, radius, and typography. Compose existing primitives like Section, Stack, and FormField before creating new ones.

Which @iwana/ui components are currently implemented?

Button, Input, Card, Badge, OtpInput, ThemeProvider, and ThemeToggle are implemented and exported from packages/ui/src/index.ts. Components like Checkbox, Select, Modal, Toast, and Table are roadmap items and must not be imported yet.

How does Tailwind 4 CSS-first configuration work with design tokens?

Tokens are defined in the @theme block of globals.css instead of a tailwind.config.js file. Components consume semantic token names such as fg-default, bg-surface, and accent-primary through Tailwind utility classes.

Can I use React Native components in this web frontend?

No. Importing View or Text from react-native is an explicit anti-pattern in this web stack. Use the system's own web primitives such as Section and Text from the shared UI package instead.

When should I create a new UI primitive instead of composing existing ones?

Only when the need cannot be met by composing existing primitives. New primitives need a small consistent API, semantic naming, disabled/loading/error states, keyboard navigation, visible focus, and basic render and accessibility tests.