kevin-design-system

A React component library for Kevin Design System.

Installation

npm install kevin-design-system

react and react-dom are peer dependencies and must already exist in the consuming app.

Usage

The package entry automatically loads the bundled library styles, so you can import components directly without a separate CSS import.

import { Button, TextInput } from 'kevin-design-system';

export function Example() {
  return (
    <div className="flex flex-col gap-4">
      <TextInput placeholder="Type something" />
      <Button>Button</Button>
    </div>
  );
}

React Native (App) Components

Components prefixed with App (e.g. AppButton, AppToast) target React Native and live in a separate entry point so the default web entry never pulls in react-native:

import { AppButton } from 'kevin-design-system/app';

react-native is an optional peer dependency — only required if you import from kevin-design-system/app.

Included Categories

• Foundation: Typography
• Action: Button, ButtonGroup, Dropdown, Modal, Drawer
• Input: TextInput, Select, Checkbox, Radio, Switch, DatePicker, UploadDropzone
• Navigation: Pagination, Tabs, BreadCrumb
• Data Display: Avatar, Badge, MetricCard, Table, Tag, Tooltip
• Feedback: Alert, Progress, Skeleton, Toast
• Layout: Box, FlexWrapper, Grid, Divider
• Interaction: CountUp, SplitText, Sticker
• Mobile: BottomNavigation, TopAppBar, BottomSheet, NavDrawer

Styling Notes

• Library styles are bundled into the package entry automatically.
• Dark mode follows a .dark class on an ancestor.
• The theme uses Pretendard and Tossface font-family names when available. If those fonts are not loaded in the consumer app, the browser will fall back to system fonts.

Build the Library

npm run build:lib

This produces:

• dist-lib/index.js / dist-lib/index.cjs (web entry, no react-native)
• dist-lib/app.js / dist-lib/app.cjs (React Native entry, kevin-design-system/app)
• dist-lib/styles.css
• dist-lib/types

Local Package Check

npm pack

This creates a tarball you can install in another project for verification before publishing.