Initium blocks are shadcn-compatible React sections and page pieces. Install them through the @initium registry namespace after your project has shadcn and Initium styles configured.
Before You Install
Make sure you have:
- Initialized shadcn in your project.
- Added the Initium registry to
components.json. - Installed an Initium style preset or the base style pack.
- Set
INITIUM_LICENSE_KEYif the block is a pro item.
Install the base style pack if you have not installed styles yet:
npx shadcn@latest add @initium/initium-stylesInstall A Block
Use the Blocks browser to choose the exact block name, then install it with shadcn:
npx shadcn@latest add @initium/hero-section-1The CLI adds the block source code and any required dependencies to your project.
Blocks are built on Base UI and delivered for your project's style automatically. Projects on a base-* style receive the current Base UI build; projects on a radix-* or legacy style receive the frozen Radix build, which stays available for existing customers but no longer receives new blocks.
Free And Pro Blocks
Some registry items are free. Pro blocks require a valid license key:
INITIUM_LICENSE_KEY=your_polar_license_keyIf you can install @initium/initium-styles but a pro block fails with an authorization error, your registry setup works and the license key needs attention.
Install Examples
npx shadcn@latest add @initium/hero-section-1
npx shadcn@latest add @initium/button-default
npx shadcn@latest add @initium/form-elements-defaultUse the Blocks browser as the source of truth for available block names. The docs show representative commands instead of duplicating the full block catalog.
After Installing
Import the installed block into your route or component and pass your real content through the supported props.
Keep the installed style preset intact. If a block looks unstyled, install Initium styles first and confirm the target project is using the global CSS file configured by shadcn.