Everything you need to ship with Lumenite
Lumeniteisn’t an npm package you install — it’s a library of components you copy into your own codebase, own outright, and customize freely. This page covers everything from initial setup to theming to licensing.
Getting started
Lumenite components are built for Next.js with the App Router, styled with Tailwind CSS v4, and animated with Framer Motion. They’ll also work in any React project with Tailwind configured — Next.js is just what we build and test against.
Install the small set of dependencies most components rely on:
npm i framer-motion clsx tailwind-merge lucide-reactIf your project doesn’t already have Tailwind CSS v4 set up, follow the official Tailwind installation guide first — Lumenitecomponents assume Tailwind utility classes are available and use v4’s @theme token system for color and font variables.
The cn() utility
Nearly every component uses a small cn() helper to merge Tailwind class names safely, so conditional classes and consumer-supplied classNameprops don’t collide. Add this once to your project at lib/utils.ts:
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs));
}Every Lumenite component snippet imports this from @/lib/utils — adjust the import path if your project structure differs.
Copy-paste workflow
There’s no package to add to your package.json and no black-box dependency to upgrade later. Instead:
- Browse the /components gallery and preview components live, in both light and dark mode where relevant.
- Click a component to open its detail page and copy the full source code with one click.
- Paste it into your project — typically as a new file under
components/ui/— and import it wherever you need it. - Edit it. It’s your code now: rename props, restyle with your own tokens, strip out what you don’t need.
Pro components follow the exact same workflow — the only difference is that the source is hidden behind your license until you unlock it. See the Licensepage for what you can and can’t do with copied code.
Theming
Components are written against a small set of semantic Tailwind tokens rather than hard-coded hex values, so re-theming your whole app means editing your globals.css @theme block once, not every component individually.
| Token | Used for |
|---|---|
| bg-void | Page background, deepest layer |
| bg-surface | Section and footer background |
| bg-panel | Cards, panels, elevated surfaces |
| border-line | Hairline borders and dividers |
| text-brand-soft | Accent text, links, highlights |
Swap the underlying color values in your @theme block and every copied component picks up your brand automatically — no find-and-replace across files.
FAQ
Do I need a license to use free components?
No. Free components can be used in unlimited personal and commercial projects with no attribution required. See the License page for the full terms.
Can I use Pro components on client projects?
Yes — a Pro license covers unlimited personal and client projects. What it doesn’t cover is redistributing the component source itself as a standalone product. Full details on the License page.
How many people can use a Team license?
Up to ten developers within the same organization. See License for details.
Can I get a refund?
We offer a 7-day refund window for reasonable evaluation use. See our Refund Policy for the exact terms.