luminescent
v0.1.7
Published
A collection of premium, highly-polished, and visually stunning React UI components tailored specifically for modern dark-mode applications.
Readme
Luminescent ✨
A collection of premium, highly-polished, and visually stunning React UI components tailored specifically for modern dark-mode applications.
Luminescent is built with an obsession for detail, focusing on smooth micro-animations, mathematically precise glowing effects, and rich, vibrant aesthetics that instantly elevate any user interface.
🚀 Features
- Mathematical Precision: Utilizes advanced modern CSS techniques (
@property,padding-boxclipping) to create flawless, infinitely scalable glowing borders without bleed or stretch. - Dynamic Interactions: Components feature fluid sliding indicators, discrete fades, and magnetic hover effects powered by Framer Motion.
- Premium Aesthetics: Curated dark-mode color palettes featuring rich blacks (
#050505), glassmorphism, and vibrant gradient blooms. - Drop-in Ready: Built with React and Tailwind CSS. Just copy the component and its dependencies into your codebase.
📦 Components Included
- TextField: Features a hyper-smooth, animated "single stream" light gradient that actively orbits the input border while focused.
- SegmentedControl: A pill-shaped layout control featuring a beautifully animated, sliding active indicator that snaps seamlessly between options.
- RadioGroup: Offers both vertical and horizontal layouts, supporting customizable light variants (slide or fade) to indicate active states.
- Button: Highly stylized primary and secondary buttons featuring peachy, ambient blooms and deeply interactive hover states.
- Divider: A gorgeous visual separator that emits a soft, fading glow from the edges or center to break up content beautifully.
🛠️ Technology Stack
- React (v19)
- Tailwind CSS (v3.4)
- Framer Motion (for complex fluid layout animations)
- Vite & Storybook (for component development and preview)
📖 Viewing the Playground
Luminescent uses Storybook to showcase all components in an interactive, dark-themed playground.
# Install dependencies
npm install
# Start the interactive Storybook playground
npm run storybook🌐 Deployment
This project includes a zero-configuration netlify.toml file. To deploy the interactive Storybook playground to Netlify:
- Connect this repository to your Netlify dashboard.
- Netlify will automatically build the static Storybook using
npm run build-storybookand serve it from thestorybook-staticdirectory.
