@mild-ui/core
v0.3.1
Published
Universal design system built with SASS/SCSS - framework agnostic CSS-only core with zero dependencies
Readme
@mild-ui/core
Pure CSS/SCSS design system with Tailwind-like utilities - framework agnostic with zero dependencies
Overview
@mild-ui/core provides a comprehensive CSS/SCSS design system with utility classes similar to Tailwind CSS, but with the mild- prefix to avoid conflicts. This package contains only CSS and SCSS files - no TypeScript types or JavaScript utilities.
Features
- Tailwind-like utilities with
mild-prefix (no conflicts!) - Design tokens as CSS custom properties
- Component styles for React/Vue packages
- Dark/Light themes with automatic switching
- Responsive design with mobile-first approach
- Zero dependencies - pure CSS/SCSS only
Installation
npm install @mild-ui/coreUsage
Import CSS utilities only:
@import '@mild-ui/core/css/utilities';Import full design system (utilities + components):
@import '@mild-ui/core/css';Import SCSS for customization:
@use '@mild-ui/core/scss';Minified versions:
@import '@mild-ui/core/css/min';
@import '@mild-ui/core/css/utilities/min';Available Utility Classes
All utilities use the mild- prefix to avoid conflicts with Tailwind CSS:
<!-- Layout -->
<div class="mild-flex mild-items-center mild-justify-between">
<!-- Spacing -->
<div class="mild-p-4 mild-m-2 mild-gap-4">
<!-- Colors -->
<div class="mild-bg-primary-500 mild-text-white">
<!-- Typography -->
<h1 class="mild-text-xl mild-font-bold">
<!-- Borders -->
<div class="mild-border mild-border-gray-200 mild-radius-md">Use with Tailwind CSS
Since all utilities use the mild- prefix, you can use both libraries together:
<div class="flex items-center"> <!-- Tailwind -->
<div class="mild-p-4 mild-bg-primary-100"> <!-- Mild UI -->
No conflicts!
</div>
</div>Theming
Automatic dark mode support:
/* System preference */
@media (prefers-color-scheme: dark) { /* handled automatically */ }
/* Manual toggle */
<html data-theme="dark">Package Exports
@mild-ui/core/css- Full CSS (utilities + components)@mild-ui/core/css/min- Minified full CSS@mild-ui/core/css/utilities- Utilities only@mild-ui/core/css/utilities/min- Minified utilities@mild-ui/core/scss- Main SCSS entry point@mild-ui/core/scss/utilities- Utilities SCSS only@mild-ui/core/themes/light- Light theme CSS@mild-ui/core/themes/dark- Dark theme CSS@mild-ui/core/tokens- Design tokens JSON
Documentation
- Utilities Guide - Complete list of utility classes
- Storybook - Interactive examples
Framework Packages
This core package is used by:
@mild-ui/react- React components@mild-ui/vue- Vue components
License
MIT
