0.2.5 • Published 9 months ago

@quickat/ui v0.2.5

Weekly downloads
-
License
ISC
Repository
github
Last release
9 months ago

@quickat/ui

A customizable UI component library built with TypeScript and Tailwind CSS, featuring Input Field, Checkbox, Button, Modal Box, and Badge components.

Features

  • 🔹 Fully Customizable: Easily style and configure each component with Tailwind CSS.
  • 🚀 Lightweight & Fast: Optimized for performance with minimal dependencies.
  • 🎨 Theme-Friendly: Works seamlessly with your existing Tailwind theme.
  • 🔄 Reusable Components: Designed for flexibility and reusability across projects.
  • ⚡ TypeScript Support: Strongly typed components for better developer experience.
  • 📦 Modular & Scalable: Use only the components you need.
  • 🌐 Responsive & Accessible: Built with accessibility and responsiveness in mind.

Installation

npm install @quickat/ui

Add Stylings

In the tailwind.config.js file, adjust the content array to include the @quickat/ui/dist/global.css file.

module.exports = {
    content: [
        // ...content
        "./node_modules/@quickat/ui/dist/**/*.js"
    ]
}

Requirements

  • React: v18.0.0 or later
  • Tailwind CSS: v3.0.0 or later
  • Other Dependencies:
    • lodash: >=4.17.21
    • lucide-react: >=0.475.0

Components

All components are fully customizable using Tailwind CSS and props.

ComponentDescription
InputFieldCustomizable input field with inbuilt toggles for edit and password.
ClickButttonCustomizable button with 34 different varients.
MonoTixBoxSingle checkbox component.
TixBoxMulti checkbox group component where you can customize multi select or single select.
ModalBoxModal component with title, content, and actions.
BadgeBadge component for labels and notifications.

Component Props

InputField

Prop NameTypeDescriptionDefault
typetext | password | email | date | month | tel | number | hiddenSpecifies the input type."text"
labelstringLabel for the input field.""
descriptionstringAdditional description below the label.""
verifiedboolean | noneShows a verification indicator."none"
editablebooleanDetermines if the input is editable.true
errorMessagestringDisplays an error message.""
mainContainerStyles_fistringCustom styles for the main container.""
infoContainerStyles_fistringCustom styles for the info container.""
labelStyles_fistringCustom styles for the label.""
descriptionStyles_fistringCustom styles for the description.""
inputStyles_fistringCustom styles for the input field.""
errorStyles_fistringCustom styles for the error message.""

ClickButton

Prop NameTypeDescriptionDefault
labelstringBadge text content."Click"
variantdefault | alternative | dark | light | green | red | yellow | purple | gradient-blue | gradient-green | gradient-cyan | gradient-teal | gradient-lime | gradient-red | gradient-pink | gradient-purple | shadow-blue | shadow-green | shadow-cyan | shadow-teal | shadow-lime | shadow-red | shadow-pink | shadow-purple | outline-blue | outline-dark | outline-green | outline-red | outline-yellow | outline-purple | purple-blue | cyan-blue | green-blue | purple-pink | pink-orangeDefines the Button style."default"
size'xs' | 'sm' | 'base' | 'lg' | 'xl'Defines the size of the button"base"
loadingbooleanDefines is button in loading state"false"
buttonStylestringAddational tailwind classes""

MonoTixBox

Prop NameTypeDescriptionDefault
labelstringLabel for the tick box.""
requiredbooleanMarks the tick box as required.false
descriptionstringAdditional description below the label.""
disabledbooleanDisables the tick box.false
optionBoxOptionTypeTick box option details.{ label: "TickBox", required: true, checked: false }
variantBoxVariantDefines the tick box variant style."default"
onTick(updatedOptions: BoxOptionType) => voidCallback function triggered on tick change.() => {}
errorMessagestringDisplays an error message.""
mainContainerStyles_mtbstringCustom styles for the main container.""
infoContainerStyles_mtbstringCustom styles for the info container.""
labelStyles_mtbstringCustom styles for the label.""
descriptionStyles_mtbstringCustom styles for the description.""
mtbContainerStyles_mtbstringCustom styles for the MonoTixBox container.""
optionStyle_mtbstringCustom styles for the option.""
boxStyle_mtbstringCustom styles for the tick box.""
errorStyles_mtbstringCustom styles for the error message.""

TixBox

Prop NameTypeDescriptionDefault
labelstringLabel for the tick box group.""
requiredbooleanMarks the tick box group as required.false
descriptionstringAdditional description below the label.""
disabledbooleanDisables all tick boxes in the group.false
options *BoxOptionType[]List of tick box options.[]
multiSelectbooleanAllows multiple selections.false
variantdefault | f-defaul | green | f-green | red | f-red | yellow | f-yellow | purple | f-purple'Defines the tick box variant style."default"
onTick(updatedOptions: BoxOptionType[], changedOption: BoxOptionType) => voidCallback function triggered on tick change.() => {}
errorMessagestringDisplays an error message.""
mainContainerStyles_tbstringCustom styles for the main container.""
infoContainerStyles_tbstringCustom styles for the label/description container.""
labelStyles_tbstringCustom styles for the label.""
descriptionStyles_tbstringCustom styles for the description.""
tbContainerStyles_tbstringCustom styles for the tick box container.""
optionStyle_tbstringCustom style for options""
errorStyles_tbstringcustom style for error message""

Badge

Prop NameTypeDescriptionDefault
label *stringBadge text content.undefined
variantprimary | secondaryDefines the badge varient."primary"
sizexs | sm | mdDefines the size of the badge."sm"
colorblue | gray | green | red | yellow | purple | white | black | noneDefines the badge style."default"
badgeStylestringAddational tailwind classes.""

Developer Information

  • Library Maintainer: Shirish
  • Version: 1.0.0
  • License: MIT
  • GitHub Repository: GitHub Link

More components and props will be added soon to further enhance the customization options!


This documentation will be updated regularly to include all features and components. Stay tuned for more updates! 🚀

0.2.5

9 months ago

0.2.4

9 months ago

0.2.3

9 months ago

0.2.2

9 months ago

0.2.1

9 months ago

0.2.0

9 months ago

0.1.9

9 months ago

0.1.8

9 months ago

0.1.7

9 months ago

0.1.6

9 months ago

0.1.5

9 months ago

0.1.4

9 months ago

0.1.3

9 months ago

0.1.2

9 months ago

0.1.1

9 months ago

0.1.0

9 months ago

0.0.9

9 months ago

0.0.8

9 months ago

0.0.7

9 months ago

0.0.6

9 months ago

0.0.5

9 months ago

0.0.4

9 months ago

0.0.3

9 months ago

0.0.2

9 months ago

0.0.1

9 months ago