BigBlocks

Installation

PreviousNext

Install BigBlocks components in your project

Prerequisites

BigBlocks components are designed to work with React applications. Make sure you have:

  • React 18 or later
  • Tailwind CSS v4
  • TypeScript (recommended)

Installation

BigBlocks provides a CLI tool to easily add components to your project.

Using the CLI

Install components directly from the registry:

bunx shadcn@latest add https://registry.bigblocks.dev/r/step-indicator.json

The shadcn CLI copies the component source into your project along with any required dependencies — you own the code and can customize it freely.

Manual Installation

Every component page includes the full source under the Code tab. To install manually, copy the files into your project (by convention under components/bigblocks/) and install the npm dependencies listed on the component page.

Configuration

Tailwind CSS

BigBlocks requires Tailwind CSS v4, which is configured in CSS rather than a tailwind.config.js file:

/* globals.css */
@import "tailwindcss";

Installed components live in your own source tree, so Tailwind picks up their classes automatically — no extra content configuration is needed.

TypeScript

BigBlocks is written in TypeScript and provides full type definitions. No additional configuration is required.

Next Steps

ConventionsBigBlocks Provider