Component Dock ⚓

Your Component Library Scaffold Tool

Component Dock is a powerful CLI tool that helps you quickly scaffold modern React component libraries with shadcn/ui integration, TypeScript support, and production-ready build configuration.

🎯 Why Component Dock?

The Problem with Direct Third-Party Components

Modern React projects heavily rely on third-party component libraries like shadcn/ui, which work great for small teams and projects. However, as teams grow and projects scale, several critical issues emerge:

🚨 Team Collaboration Challenges:

• Multiple developers modifying the same components simultaneously
• One person's changes breaking existing functionality for others
• Inconsistent component implementations across different features
• Difficulty tracking who changed what and when

⚠️ Scalability Issues:

• No centralized control over component behavior and styling
• Duplicated component logic scattered across the codebase
• Hard to maintain design system consistency
• Challenging to implement organization-wide design updates

🔧 Maintenance Nightmares:

• Direct dependency on external component libraries without abstraction
• Breaking changes in third-party libraries affecting the entire project
• Difficulty in customizing components to match specific requirements
• No version control over component modifications

The Solution: Your Own Component Library

🎯 Standardization & Control:

• Centralized component definitions that everyone follows
• Version-controlled component changes with proper review processes
• Consistent API and behavior across your entire organization
• Custom components tailored to your specific design requirements

👥 Team Efficiency:

• Clear ownership and contribution guidelines for components
• Reusable components across multiple projects
• Reduced development time through shared component ecosystem
• Better collaboration through well-defined component interfaces

🔄 Long-term Maintainability:

• Easy to update, test, and deploy component changes
• Independence from third-party library breaking changes
• Ability to gradually migrate or update underlying technologies
• Documentation and examples that grow with your team's needs

Component Dock bridges this gap by providing you with a production-ready foundation to build and maintain your own component library, giving you the best of both worlds: the speed of shadcn/ui components and the control of your own ecosystem.

✨ Features

• 🚀 Quick Setup - Create a complete component library in seconds
• 📦 Dual Package Support - Builds both CommonJS and ESM formats
• 🔧 TypeScript Ready - Full TypeScript support with proper declarations
• 🎭 Tailwind CSS - Pre-configured with custom design tokens
• 📱 Modern Build Stack - Rollup, PostCSS, and optimized bundling
• 🎯 Interactive Setup - Guided project configuration
• 📖 Complete Documentation - Generated README and usage examples

📦 Installation

Global Installation (Recommended)

npm install -g component-dock

NPX Usage (No Installation Required)

npx component-dock create my-library

🚀 Quick Start

Create a New Component Library

component create my-awesome-library

The CLI will guide you through an interactive setup:

🚀 Creating component library: my-awesome-library

? Library description: A collection of awesome React components
? Choose package manager: npm

Project Structure Created

my-awesome-library/
├── src/
│   ├── components/
│   │   └── ui/           # shadcn/ui components go here
│   ├── lib/
│   │   └── utils.ts      # Utility functions (cn helper)
│   ├── styles/
│   │   └── globals.css   # Global styles and CSS variables
│   └── index.ts          # Main export file
├── dist/                 # Built files (generated)
│   ├── cjs/             # CommonJS build
│   ├── esm/             # ES Modules build
│   ├── styles/          # Compiled CSS
│   └── index.d.ts       # Type declarations
├── package.json          # Package configuration
├── tsconfig.json         # TypeScript configuration
├── rollup.config.js      # Build configuration
├── tailwind.config.js    # Tailwind CSS configuration
├── postcss.config.js     # PostCSS configuration
├── components.json       # shadcn/ui configuration
└── README.md            # Project documentation

🛠️ Usage

Available Commands

# Create a new component library
component create <project-name>

# Create with options
component create my-library --skip-install

# Show help
component --help

# Show version
component --version

Command Options

create <project-name>

Creates a new component library project.

Options:

• --skip-install - Skip automatic dependency installation

Example:

component create design-system --skip-install

🏗️ Development Workflow

After creating your library, navigate to the project directory and start developing:

cd my-awesome-library

# Install dependencies (if not already installed)
npm install

# Start development with watch mode
npm run dev

# Build the library
npm run build

# Type checking
npm run type-check

# Clean build artifacts
npm run clean

You're absolutely right! The "Adding Components" section should be more comprehensive and flexible. Here's a better version:

📚 Adding Components

Your project comes pre-configured for shadcn/ui components, but you have complete flexibility in how you build your component library:

Using shadcn/ui CLI (Recommended)

# Add specific components
npx shadcn-ui@latest add button input

# Interactive component selection
npx shadcn-ui@latest add

Manual Component Creation

Create your own components from scratch:

# Create a new component directory
mkdir src/components/ui/custom-button

# Add your component files
touch src/components/ui/custom-button/index.tsx
touch src/components/ui/custom-button/custom-button.stories.tsx

Using Other Component Libraries

Install and integrate components from other libraries:

# Radix UI primitives
npm install @radix-ui/react-dialog @radix-ui/react-dropdown-menu

Copying from External Sources

You can also copy and adapt components from:

• shadcn/ui components - Copy source code directly
• Radix UI examples - Use their component patterns
• Tailwind UI - Adapt their component designs
• Other open-source component libraries

Exporting Components

After adding any components, make sure to export them from your main index.ts file:

// src/index.ts
export { Button } from './components/ui/button';
export { Input } from './components/ui/input';
export { CustomButton } from './components/ui/custom-button';

🔧 Configuration

Package.json Scripts

The generated project includes these npm scripts:

{
  "scripts": {
    "build": "rollup -c",
    "dev": "rollup -c -w",
    "lint": "eslint src --ext .ts,.tsx",
    "type-check": "tsc --noEmit",
    "clean": "rm -rf dist"
  }
}

Build Output

The build process generates:

• dist/cjs/ - CommonJS modules for Node.js compatibility
• dist/esm/ - ES modules for modern bundlers
• dist/index.d.ts - TypeScript declaration files
• dist/styles/ - Compiled CSS files

Dependencies Included

Your component library comes with:

Runtime Dependencies:

• @radix-ui/react-slot - Primitive components
• class-variance-authority - Variant API for components
• clsx - Conditional className utility
• tailwind-merge - Tailwind class merging
• lucide-react - Icon library
• tslib - TypeScript runtime helpers

Development Dependencies:

• Full TypeScript support
• Rollup build configuration
• Tailwind CSS with plugins
• ESLint setup

📖 Usage in Projects

After building and publishing your library:

npm install my-awesome-library

import { Button, Input } from 'my-awesome-library';
import 'my-awesome-library/dist/styles/globals.css';

function App() {
  return (
    <div>
      <Button variant="primary">Click me</Button>
      <Input placeholder="Enter text..." />
    </div>
  );
}

🚀 Publishing

# Build your library
npm run build

# Publish to npm
npm publish

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

Development Setup

# Clone the repository
git clone https://github.com/aaqeb11/component-dock.git

# Install dependencies
npm install

# Link for local development
npm link

# Test the CLI
component create test-library

📄 License

MIT License - see the LICENSE file for details.

Component Dock - ⚓ Scaffold your component libraries with confidence