No description

Find a file

autocommit 1be7aed898 Some checks failed Publish / publish (push) Failing after 1s Details deps-upgrade(deps): ⬆️ Update dependencies to latest versions for security patches and bug fixes Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>		2026-06-10 11:20:18 -07:00
.forgejo/workflows	chore: initial package split from monorepo	2026-04-20 01:10:58 -07:00
src	chore: initial package split from monorepo	2026-04-20 01:10:58 -07:00
.gitignore	chore: add .gitignore, remove node_modules/dist/.turbo from tracking	2026-04-20 01:12:53 -07:00
eslint.config.js	chore: initial package split from monorepo	2026-04-20 01:10:58 -07:00
package.json	deps-upgrade(deps): ⬆️ Update dependencies to latest versions for security patches and bug fixes	2026-06-10 11:20:18 -07:00
README.md	chore: initial package split from monorepo	2026-04-20 01:10:58 -07:00
tsconfig.json	chore: initial package split from monorepo	2026-04-20 01:10:58 -07:00

README.md

@lilith/ui-core

A unified UI component library that re-exports all @lilith/ui-* packages for backward compatibility. This meta-package provides a single import point for the entire component ecosystem.

Features

Unified Exports - Single import point for all UI components
Layered Architecture - Components organized by abstraction level (L0-L3)
Backward Compatibility - Supports existing imports while transitioning to specific packages
Tree-Shakeable - Only imports what you use

Installation

npm install @lilith/ui-core
# or
pnpm add @lilith/ui-core

Peer Dependencies

npm install react react-dom styled-components

Usage

Unified Import (Backward Compatible)

import {
  Button,
  Card,
  Container,
  LineChart,
  DataTable
} from '@lilith/ui-core';

Recommended: Specific Package Imports

For better tree-shaking and faster builds, import from specific packages:

// Primitives (L1)
import { Button, Input, Card } from '@lilith/ui-primitives';

// Layout (L1)
import { Container, Grid, Stack } from '@lilith/ui-layout';

// Charts (L2)
import { LineChart, BarChart, PieChart } from '@lilith/ui-charts';

// Data (L2)
import { DataTable, Pagination } from '@lilith/ui-data';

Package Hierarchy

Foundation (L0)

@lilith/ui-utils - Utility functions and helpers

Primitives (L1)

@lilith/ui-primitives - Basic components (Button, Input, Card, etc.)
@lilith/ui-glassmorphism - Glassmorphic styled components
@lilith/ui-layout - Layout components (Container, Grid, Stack)
@lilith/ui-typography - Typography components

Interactive (L2)

@lilith/ui-feedback - Feedback components (Toast, Modal, etc.)
@lilith/ui-navigation - Navigation components
@lilith/ui-data - Data display components (Tables, Lists)
@lilith/ui-forms - Form components
@lilith/ui-animated - Animation components
@lilith/ui-charts - Chart components

Domain (L3)

@lilith/ui-realtime - Real-time data components
@lilith/ui-ranking - Ranking and leaderboard components
@lilith/ui-payment - Payment-related components
@lilith/ui-error-pages - Error page templates

Dependencies

This package re-exports the following packages:

Package	Description
`@lilith/ui-utils`	Utility functions
`@lilith/ui-primitives`	Basic UI components
`@lilith/ui-glassmorphism`	Glassmorphic components
`@lilith/ui-layout`	Layout utilities
`@lilith/ui-typography`	Typography components
`@lilith/ui-feedback`	Feedback components
`@lilith/ui-navigation`	Navigation components
`@lilith/ui-data`	Data display components
`@lilith/ui-forms`	Form components
`@lilith/ui-animated`	Animation components
`@lilith/ui-charts`	Chart components
`@lilith/ui-realtime`	Real-time components
`@lilith/ui-ranking`	Ranking components
`@lilith/ui-payment`	Payment components
`@lilith/ui-error-pages`	Error pages
`@lilith/ui-themes`	Theme definitions

Migration Guide

When migrating from @lilith/ui-core to specific packages:

// Before
import { Button, Container, LineChart } from '@lilith/ui-core';

// After
import { Button } from '@lilith/ui-primitives';
import { Container } from '@lilith/ui-layout';
import { LineChart } from '@lilith/ui-charts';

License

MIT