Installation
Kontenedor works with any React framework (Next.js, Vite, Remix, Astro) and Tailwind CSS v4.
1. Initialize
npx kontenedor init
This creates kontenedor.json, copies the tokens (styles/kontenedor.css, styles/tailwind.css) and the cn() utility, and installs clsx and tailwind-merge.
2. Import the styles
In your main CSS file:
@import "tailwindcss";
@import "./components/kontenedor/styles/tailwind.css";
@source "./components/kontenedor";
3. Load Google Fonts and Material Symbols
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@100..900&family=Geist+Mono:wght@100..900&display=swap" />
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Rounded:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=block" />
In Next.js put these in app/layout.tsx inside <head>.
4. Add components
npx kontenedor add button card input
npx kontenedor add --all # everything your license allows
Dependencies (other components, npm packages) are resolved automatically.
5. Pro license
After purchase, Polar emails your license key. Add it once:
npx kontenedor login kt_your_license_key
# or set the environment variable
export KONTENEDOR_LICENSE=kt_your_license_key
6. Use it
import { Button } from "@/components/kontenedor/ui/button";
export default function Page() {
return <Button leadingIcon="rocket_launch">Launch</Button>;
}
Set the weight on <html data-weight="medium"> (or thin / bold) and the theme with the dark class.
Alternative: clone the repository
Buyers get access to the private GitHub repository. You can use the monorepo directly (pnpm install && pnpm storybook) or consume packages/ui as a workspace package.