mainbase-ui 1.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mainbase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,279 @@
+# Mainbase UI
+
+Mainbase UI is a React component library built with React and TypeScript.
+
+The library provides reusable interface components, a customizable theme system,
+CSS variables, and typed component APIs for building web applications.
+
+## Requirements
+
+- React 18 or higher
+- React DOM 18 or higher
+- TypeScript 5 or higher (recommended)
+
+## Installation
+
+Install the package using npm:
+
+```bash
+npm install mainbase-ui
+
+or using pnpm:
+
+pnpm add mainbase-ui
+
+or using yarn:
+
+yarn add mainbase-ui
+Basic Usage
+
+Import the global styles:
+
+import "mainbase-ui/styles.css";
+
+Import required components:
+
+import {
+  MainbaseProvider,
+  Button,
+} from "mainbase-ui";
+
+Example:
+
+export default function App() {
+  return (
+    <MainbaseProvider>
+      <Button>
+        Click me
+      </Button>
+    </MainbaseProvider>
+  );
+}
+MainbaseProvider
+
+MainbaseProvider is the root configuration component.
+
+It provides:
+
+theme configuration;
+component default values;
+design tokens;
+CSS variables.
+
+Example:
+
+<MainbaseProvider
+  theme={{
+    colors: {
+      primary: "#ff8a1f",
+      primaryHover: "#f47c0f",
+      primaryActive: "#dd6d06",
+    },
+
+    radii: {
+      sm: 4,
+      md: 4,
+      lg: 4,
+      xl: 4,
+      full: 999,
+    },
+  }}
+>
+  <App />
+</MainbaseProvider>
+Theme Configuration
+
+The theme system allows changing global interface values.
+
+Supported theme sections:
+
+colors;
+typography;
+radii;
+spacing;
+shadows;
+transitions;
+z-index;
+component defaults.
+
+Example:
+
+<MainbaseProvider
+  theme={{
+    typography: {
+      fontFamily:
+        "Manrope, sans-serif",
+    },
+
+    colors: {
+      primary: "#2563eb",
+    },
+  }}
+>
+  <App />
+</MainbaseProvider>
+Colors
+
+Available color tokens:
+
+colors: {
+  primary,
+  primaryHover,
+  primaryActive,
+
+  text,
+  textSecondary,
+  textMuted,
+
+  background,
+  backgroundSecondary,
+
+  border,
+  borderHover,
+
+  success,
+  warning,
+  danger,
+  info
+}
+Border Radius
+
+Global component radius can be configured:
+
+<MainbaseProvider
+  theme={{
+    radii: {
+      sm: 4,
+      md: 4,
+      lg: 4,
+      xl: 4,
+      full: 999,
+    },
+  }}
+>
+
+These values are used by components automatically.
+
+Typography
+
+Example:
+
+<MainbaseProvider
+  theme={{
+    typography: {
+      fontFamily:
+        "Manrope, sans-serif",
+    },
+  }}
+>
+Components
+
+Mainbase UI includes the following components.
+
+Layout
+Stack
+Group
+Card
+Divider
+Typography
+Text
+Title
+Buttons
+Button
+IconButton
+Inputs
+Input
+Textarea
+PasswordInput
+PinInput
+Select
+FileInput
+DatePicker
+Selection
+Checkbox
+Radio
+Switch
+Feedback
+Alert
+Badge
+Spinner
+Progress
+Skeleton
+Toast
+Navigation
+Tabs
+Accordion
+Pagination
+Overlay
+Modal
+Drawer
+Menu
+Popover
+Tooltip
+User Components
+Avatar
+AvatarGroup
+Component Defaults
+
+Default component settings can be configured through the theme.
+
+Example:
+
+<MainbaseProvider
+  theme={{
+    components: {
+      Button: {
+        size: "lg",
+        variant: "primary",
+      },
+
+      Card: {
+        radius: "md",
+      },
+    },
+  }}
+>
+TypeScript Support
+
+Mainbase UI provides TypeScript definitions for all public components.
+
+Example:
+
+import type {
+  ButtonProps,
+  DatePickerProps,
+} from "mainbase-ui";
+CSS Variables
+
+Mainbase UI exposes CSS variables that can be customized.
+
+Example:
+
+:root {
+  --mb-primary: #ff8a1f;
+  --mb-radius: 8px;
+}
+Accessibility
+
+Components are designed with accessibility support:
+
+keyboard navigation;
+ARIA attributes;
+focus states;
+disabled states.
+Browser Support
+
+Mainbase UI supports modern browsers:
+
+Chrome
+Edge
+Firefox
+Safari
+License
+
+Mainbase UI is distributed under the MIT License.
+
+You are free to use, modify, and distribute this software
+according to the terms of the license.
+
+See the LICENSE file for full license text.