eglador-ui-react

A lightweight, reusable UI component library built with Tailwind CSS v4 for React-based projects.

Installation

npm install eglador-ui-react

Peer dependencies: react >= 18 | react-dom >= 18 | tailwindcss ^4

Optional (for Carousel): embla-carousel ^8 | embla-carousel-react ^8 | plugin packages as needed (embla-carousel-autoplay, embla-carousel-fade, etc.)

Setup

Add the following to your global stylesheet (e.g. app/globals.css) so Tailwind can detect the component classes:

@import "tailwindcss";
@source "../node_modules/eglador-ui-react/dist/**/*.{js,mjs}";

Usage

import { Button, Input, Modal } from "eglador-ui-react";

Components

| Category | Components | |----------|-----------| | Actions | Button, ButtonGroup, Link, SpeedDial | | Forms | Input, InputGroup, InputOTP, Calendar, DatePicker, DateTimePicker, Textarea, Select, NativeSelect, MultiSelect, Checkbox, CheckboxGroup, Radio, RadioGroup, Switch, Label | | Feedback | Alert, Notification, Toast, Progress, Spinner, Skeleton | | Navigation | NavigationMenu, Menubar, Pagination, Stepper, Breadcrumb | | Data Display | DataTable, Table, Accordion, Tabs, TreeView, Badge, Avatar, Empty, Kbd, Tooltip, Typography, Typewriter | | Overlays | Dialog, Drawer, Dropdown, Popover, HoverCard, AlertDialog, ContextMenu, Command | | Layout | Sidebar, Separator, Collapsible, AspectRatio, ScrollArea, Resizable | | Media | MediaImage, MediaVideo, Carousel |

Development

npm install              # install dependencies
npm run storybook        # start storybook on http://localhost:6006
npm run build            # production build to dist/
npm run dev              # watch mode with live rebuild
npm run typecheck        # run typescript type checking

Publishing

Publishing is automated via GitHub Actions. When a GitHub Release is created, the package is automatically published to npm.

1. Update version in package.json
2. Commit and push
3. Create a GitHub Release with a matching tag (e.g. v0.1.0-alpha.16)

Compatibility

Works with any React-based framework: Next.js, Remix, Vite + React, Gatsby, and others.

Author

Kenan Gundogan — github.com/kenangundogan

License

MIT