kontenedor

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.