v0.3.0: 6 Premium Blocks, Theme Mode fixes & Wide Viewport updates

⚡️ BrutxUI v0.3.0 Release Notes

Welcome to v0.3.0! 🎉

This release introduces 6 high-impact blocks and full-page templates to help you build modern neo-brutalist landing pages, SaaS dashboards, and conversion flows in minutes. Additionally, this version fixes critical viewport layout squeezing in preview documentation containers and resolves accessibility contrast bugs on the /docs/theme page in dark mode.

---

🌟 What's New (Features)

📦 1. Six Premium Blocks & Templates

You can now copy-paste or install these full-scale layouts directly using the CLI (npx brutx add <block-name>):

• Brutalist Hero: An eye-catching landing header section with vibrant headlines, offset secondary buttons, and an interactive terminal card mockup.
• Pricing Section: A responsive three-tier pricing grid featuring highlighted cards, comprehensive checklists, and smooth hover translations.
• Auth Card: A beautiful neo-brutalist sign-in layout with complete form inputs and Google/GitHub OAuth action button states.
• Dashboard Shell: A professional panel frame including a collapsible navigation sidebar, metrics widgets, action menus, and transactional database tables.
• Empty State: An intuitive directory guidance panel with structured custom CTA buttons.
• Waitlist Page: A complete high-conversion private beta signup page featuring statistics counters and validated email captures.

🌐 2. Official Registry Integration

• All 6 new blocks are fully mapped to the central Registry schema. You can instantly install them in any React app using:
  npx brutx add <block-name>

---

🛠️ Bug Fixes & Refactoring

🖥️ Viewport Squeezing Fixes in Component Previews

• Upgraded the documentation's ComponentPreview container to support an align="stretch" prop. This resolves a critical layout bug that squeezed wide multi-column grids (like SaaS Pricing and Dashboard Stats), allowing them to expand naturally to full width.

🌓 Resolved Glaring Contrast Issues in Dark Mode

• Cleaned up the /docs/theme page by removing hardcoded light-mode background cards (bg-[#faf9f6] / bg-white) that failed to transition when switching dark/light states.
• Redesigned the Pastel Preset and Mono Preset boxes to use proper dark slate backgrounds and highly readable contrast elements, preventing eye strain.

🧪 Improved Unit Testing & DX

• Added exhaustive testing coverage for the newly developed blocks. The entire test suite compiles perfectly with 218/218 passing checks (pnpm test passes 100%).

---

🚀 Quick Start Guide

Upgrade the Brutx CLI or add the new blocks to your workspace:

# Update and add blocks via the CLI
npx brutx@latest add brutalist-hero
npx brutx@latest add pricing-section
npx brutx@latest add dashboard-shell

v0.2.4 — Architecture Audit & Security Hardening

What's Changed

🔒 Security & Robustness

• Runtime registry validation — CLI validates JSON schema before writing files to filesystem
• Fix greedy regex in resolveImportAlias — prevents import path corruption
• Guard utils.ts overwrite — brutx init no longer overwrites customized utility files

🏗️ Architecture Improvements

• New packages/shared — single source of truth for component metadata
• Eliminated cross-package .ts import hack in registry build
• brutx-shared bundled inline via tsup noExternal
• Dynamic CLI version from package.json via createRequire

📦 Package Improvements

• brutx-ui@0.2.1: Added lucide-react as peerDependency
• brutx-ui@0.2.1: Removed src/ from npm (smaller package)
• Cleaned up orphaned prototype directories

📝 Documentation

• Added 4 missing SEO entries: calendar, command, combobox, scroll-area
• Fixed CONTRIBUTING.md: Next.js 14 → 15, removed stale templates ref
• Added docs/README.md for internal architecture docs

🧪 Verified

• ✅ 195/195 tests pass
• ✅ All packages build successfully
• ✅ Registry generates all 27 components

v0.2.2 - Tailwind CSS v4 Support & Registry Refactor

🚀 Tailwind CSS v4 & v3 Native Integration & Registry-Based Refactor

This release completely refactors the Brutalist UI CLI (brutx) from static hardcoded component templates to a highly scalable, dynamic, registry-based architecture, aligning it with modern design library standards (like shadcn/ui), and adds full native support for Tailwind CSS v4 (CSS-first configuration) while maintaining complete backward compatibility for Tailwind CSS v3!

---

✨ Key Improvements

🎨 1. Native Support for Tailwind CSS v4 (CSS-First Setup)

• Auto Version Detection: CLI now automatically parses your package.json to detect if you are running Tailwind v4 (^4.0.0) or Tailwind v3 (^3.4.0).
• Bypass JS Configs: Since Tailwind v4 uses CSS-first configuration, the CLI automatically configures components.json with an empty tailwind config path ("config": "") and skips asking for tailwind.config.js on prompt.
• Tailwind v4 CSS Injector: Automatically appends Neo-Brutalist design tokens directly to your CSS-first global stylesheet (globals.css with @import "tailwindcss";) without requiring JS config modifications.

📦 2. Registry-Based Component System

• No more hardcoding: Removed all static hardcoded component templates from the CLI source code.
• Dynamic Registry: Components are loaded dynamically from a JSON registry (supports both remote HTTP registries and offline local registries).
• Packages Isolated: Dedicated packages/registry package with automated scripts to compile React .tsx components into standard registry JSON schemas.

🔄 3. Auto Dependency & Registry-Dependency Resolution

• Recursive Resolution: Added recursive resolution (DFS). Installing a component (e.g., combobox) now automatically resolves, fetches, and installs all its nested registry components (button, popover, command, dialog) in the correct order.
• NPM Package Installer: Automatically collects all npm packages needed across all installed components and triggers one-time installation via the project's package manager.

⚙️ 4. Enhanced Init & Path Traversal Security

• Zero-Config Setup: Automatically generates the components.json configuration file, utility helper lib/utils.ts (with custom cn helper), and components/ui/ directory instantly.
• Path Traversal Protection: Added absolute path safety boundaries using isSafePath to prevent potential directory traversal attacks (../../ hacks) when generating files.
• Dry Run Mode: Added --dry-run option to simulate file creations and dependencies installation without modifying the local filesystem.

---

🛠️ Installation & Usage

Initialize Brutalist UI in your project (automatically configures Tailwind v3 or v4):

npx brutx@latest init

v0.2.1 - Registry-Based Component System

🚀 Major Architectural Refactor: Transitioning to Shadcn-style Registry-Based Architecture

This release completely refactors the Brutalist UI CLI (brutx) from static hardcoded component templates to a highly scalable, dynamic, registry-based architecture, aligning it with modern design library standards (like shadcn/ui).

---

✨ Key Improvements

📦 1. Registry-Based Component System

• No more hardcoding: Removed all static hardcoded component templates from the CLI source code.
• Dynamic Registry: Components are now loaded dynamically from a JSON registry (supports both remote registries and offline local registries).
• Packages Isolated: Created a dedicated packages/registry package with automated scripts to compile React .tsx components into standard registry JSON schemas.

🔄 2. Auto Dependency & Registry-Dependency Resolution

• Recursive Resolution: Added recursive resolution (DFS). Installing a component (e.g., combobox) now automatically resolves, fetches, and installs all its nested registry components (button, popover, command, dialog) in the correct order.
• NPM Package Installer: Automatically collects all npm packages needed across all installed components and triggers one-time installation via the project's package manager.

🎨 3. Smart Import Alias Resolution

• Dynamic Mapping: Added resolveImportAlias to parse and replace registry default aliases (@/lib/utils and @/components) with the user's specific aliases configured in components.json.

⚙️ 4. Enhanced Init Command

• Zero-Config Setup: Automatically generates the components.json configuration file.
• Auto Helpers: Generates the utility file (lib/utils.ts containing the custom Neo-Brutalist cn helper) and creates a components/ui/ directory instantly.
• Tailwind Styles Creation: Automatically appends or creates new global CSS templates (globals.css) with standard Tailwind directives and Neo-Brutalist utility classes.

🧪 5. Simulation & Overwrite Features

• Dry Run Mode: Added --dry-run option to simulate file creations and dependencies installation without modifying the local filesystem.
• Robust Overwrites: Improved file conflict handling (safely skips existing files or overwrites them with --overwrite option).

---

🛠️ Installation & Usage

Initialize Brutalist UI in your project:

npx brutx@latest init

v0.1.9

What's Changed

• Develop by @dev-snake in #1
• Add custom icon generation for Next.js application by @dev-snake in #2
• feat: update metadata and keywords for improved SEO and clarity by @dev-snake in #3
• feat: update component count and version in documentation by @dev-snake in #4
• docs:update docs by @dev-snake in #5
• feat: enhance TabsPage with Checkbox component for notification prefe… by @dev-snake in #6
• Develop by @dev-snake in #7
• Develop by @dev-snake in #8
• Develop by @dev-snake in #9
• feat: add favicon and apple touch icon generation script; update meta… by @dev-snake in #10
• refactor: simplify icon route exports and update vercel configuration by @dev-snake in #11
• refactor: remove unused icon and favicon routes; simplify layout and … by @dev-snake in #12
• feat: add not-found page by @dev-snake in #13
• test deploy by @dev-snake in #14

New Contributors

• @dev-snake made their first contribution in #1

Full Changelog: v0.1.7...v0.1.9

v0.1.7 - New Features

New Features

• ✨ Command component (cmdk-based)
• ✨ Combobox component (single & multi-select)
• 📅 Calendar component (react-day-picker v9)

Improvements

• 📱 Calendar responsive fix
• 📝 Docs cho Command & Combobox
• 🔧 CLI templates mới

Versions

• brutalist-ui: 0.1.7
• brutalist-ui-cli: 0.1.3
• Total: 25 components

v0.1.5 - Official Website Launch

What's Changed

🌐 Official Website

• Updated homepage to brutalistui.site

📦 Package Updates

• Updated package metadata with official website URL

Full Changelog: v0.1.4...v0.1.5

v0.1.4 - Documentation & SEO

What's New

🌐 Website Launch

• Official docs site at brutalistui.site
• Custom domain configured

🔍 SEO Optimization

• Dynamic sitemap.xml for all pages
• robots.txt configuration
• JSON-LD structured data (SoftwareApplication schema)
• PWA manifest.json
• Open Graph & Twitter cards
• Per-component SEO metadata

📚 Documentation

• Complete docs for all 22 components
• Sponsor page with GitHub Sponsors & Buy Me a Coffee
• Fixed avatar images display

💖 Monetization

• GitHub Sponsors integration
• FUNDING.yml configuration
• Sponsor badges in README

Full Changelog

v0.1.0...v0.1.4