BadtzUI
repository·main·Indexed 42 days ago
https://github.com/badtzx0/badtz-uiA performance-optimized React UI library built with TypeScript and Tailwind CSS, specifically designed for building high-converting landing pages. It provides pre-built, fully typed components, conversion-optimized sections (Premium Blocks), and complete templates for rapid MVP development. Components can be installed via the shadcn CLI.
What's inside BadtzUI
- BadtzUI is a modern React UI library designed for rapid frontend development. It provides a collection of pre-built, high-performance components that are fully typed with TypeScript. Developers can use it to build beautiful interfaces quickly while maintaining the ability to customize themes to match specific branding requirements.
Overview of Badtz UI features and philosophy
mainBadtz UI is a free, open-source React component library specifically designed for building high-converting landing pages. Unlike generic UI libraries that focus on basic elements (buttons, inputs), Badtz UI provides specialized, production-ready sections optimized for marketing and conversion.
Key Characteristics
- Landing Page Focused: Includes hero sections, pricing tables, testimonials, and CTAs.
- Conversion-Optimized: Layouts are based on proven SaaS patterns and user psychology to drive user action.
- Modern Stack: Built using React, TypeScript, and Tailwind CSS.
- Mobile-First: All components are designed to work across all device sizes.
- Production Ready: Designed for a 'copy, paste, and ship' workflow with minimal configuration.
Core features of the Modular Glassmorphism Template
mainThe template includes several built-in optimizations and design patterns:
- Accessibility: Uses semantic HTML, proper tab order, ARIA labels, and alt text to ensure WCAG compliance.
- Animations: Powered by Motion for fluid transitions and interactivity. Animations can be customized or disabled to respect user motion preferences.
- SEO Optimization: Structured for high performance and search engine visibility out of the box.
- Design System: A modular structure using reusable components and unified project styles (typography, color tokens, and layout) for easy scaling.
Mappl Template Technical Specifications
mainThe Mappl Template is a modular SaaS template designed for legal professionals and startups. Key technical features include:
- Accessibility: WCAG-compliant out of the box using semantic HTML, proper tab order, ARIA labels, and alt text.
- Animations: Fluid, elegant animations powered by Motion that can be customized or disabled for motion-conscious users.
- SEO: Optimized for performance and search engine visibility.
- Design System: A modular architecture using reusable components and unified project styles (typography, color tokens, and layout) for easy scaling.
Use Premium Blocks for landing pages
mainPremium Blocks are complete, conversion-optimized sections designed for marketing sites and landing pages. Unlike individual free components (buttons, forms), these are ready-to-deploy sections that follow proven SaaS design patterns.
Available Block Types:
- Hero Sections: Variations with CTAs, social proof, and different visual styles.
- Pricing Tables: Layouts optimized using psychological pricing principles.
- Feature Grids: Scannable layouts for product benefits.
- Testimonials: Social proof sections for building trust.
- Call-to-Actions (CTAs): High-converting blocks focused on urgency and value.
Key Characteristics:
- Copy & Deploy: No complex configuration; copy the code and customize content.
- Mobile-Optimized: Fully responsive behavior.
- Performance-Ready: Server-side rendered for SEO and speed.
Use Complete Templates for full-page layouts
mainComplete Templates provide entire, production-ready frontends that can be deployed with minimal effort. These are ideal for rapid MVP development or creating investor-ready demos.
Available Template Types:
- Landing Pages: Multi-section marketing sites (Hero, Features, Pricing, Testimonials).
- Authentication Pages: Sign-up, sign-in, and password reset interfaces.
- Dashboard Layouts: Complete admin interfaces for SaaS backends.
Technology Stack: Templates are built using:
- Next.js App Router (SSR and performance)
- Framer Motion (Animations)
- Tailwind CSS (Styling)
- shadcn/ui (Accessible components)
- TypeScript (Type safety)
Getting Started with the Mappl SaaS Template
mainTo use the Mappl SaaS Template, follow these five steps:
- Download: Download the template package.
- Install: Install the necessary dependencies using your package manager.
- Configure: Update the configuration files to match your project requirements.
- Develop: Start the local development server using
npm run dev. - Deploy: Use the provided deployment configurations to launch your site.
The template is built using Next.js, TypeScript, Motion, and Shadcn UI.
npm run devInstall the Stripe Animated Gradient component
mainYou can install the
Stripe Animated Gradientcomponent using either the CLI or a manual installation process.Using CLI
Run the following command to add the component directly to your project:
npx shadcn@latest add https://badtz-ui.com/r/stripe-animated-gradient.jsonManual Installation
- Install dependencies:
npm install clsx tailwind-merge - Setup utility function: Ensure you have a
cnutility function in your@/libfolder:import { ClassValue, clsx } from "clsx"; import { twMerge } from "tailwind-merge"; export function cn(...inputs: ClassValue[]) { return twMerge(clsx(inputs)); } - Add Shader: Download
stripe-shader.zip, extractstripe-shader.js, and place it inside yourcomponents/uidirectory. - Add Component: Copy the
stripe-animated-gradient.tsxsource code into yourcomponents/uidirectory and update any import paths to match your project structure.
- Install dependencies:
Create a ThemeProvider component
mainCreate a client-side wrapper for
next-themesto manage theme state. This component uses the"use client"directive and re-exports theThemeProviderfromnext-themeswith standard component props."use client" import * as React from "react" import { ThemeProvider as NextThemesProvider } from "next-themes" export function ThemeProvider({ children, ...props }: React.ComponentProps<typeof NextThemesProvider>) { return <NextThemesProvider {...props}>{children}</NextThemesProvider> }Install the Blur Reveal component
mainYou can install the
BlurRevealcomponent using the shadcn CLI or by manual installation.Using CLI
Run the following command to add the component directly to your project:
npx shadcn@latest add https://badtz-ui.com/r/blur-reveal.jsonManual Installation
- Install required dependencies:
npm install clsx tailwind-merge- Ensure you have a
cnutility function in your@/libfolder:
import { ClassValue, clsx } from "clsx"; import { twMerge } from "tailwind-merge"; export function cn(...inputs: ClassValue[]) { return twMerge(clsx(inputs)); }- Copy the component source code into your project and update the import paths to match your project structure.
Configure ThemeProvider in Next.js Root Layout
mainTo apply the theme globally, wrap your application's children with the
ThemeProviderin your root layout.Important Requirements:
- Add the
suppressHydrationWarningprop to the<html>tag to prevent hydration mismatch errors caused by theme injection. - Configure the
ThemeProviderwith recommended props:attribute="class": Uses a CSS class to toggle themes.defaultTheme="system": Defaults to the user's system preference.enableSystem: Enables automatic detection of system color schemes.disableTransitionOnChange: Prevents CSS transitions from firing during theme changes, avoiding visual glitches.
import { ThemeProvider } from "@/components/theme-provider" export default function RootLayout({ children }: RootLayoutProps) { return ( <> <html lang="en" suppressHydrationWarning> <head /> <body> <ThemeProvider attribute="class" defaultTheme="system" enableSystem disableTransitionOnChange > {children} </ThemeProvider> </body> </html> </> ) }- Add the
Access Badtz UI Pro documentation
mainDetailed documentation for the Pro plan, including setup guides, customization instructions, and best practices for premium blocks and templates, is hosted at the dedicated Pro documentation URL.
https://pro.badtz-ui.com/docs/