@bloxinine/react-component-library

中文文档
2.0.2发布于 2026/10/28MITTypeScriptESM + CJS零依赖近 30 天下载 4094

An AI-slop-generated React component library built with TypeScript (Should I fire or promote my agent?)

原始使用文档
文档目录13 节
  1. Features
  2. Installation
  3. Quick Start
  4. 1. Import Global Styles
  5. 2. Wrap with ThemeProvider (Optional but Recommended)
  6. Documentation
  7. Parallax & Scroll Animations
  8. Parallax
  9. Animate on Scroll In / Scroll Out
  10. ScrollPin (Apple-Style Pinned Scrubbing)
  11. Website Sections & Layout
  12. Theming & Dark Mode
  13. License

React Component Library

An AI-slop-generated React component library built with TypeScript (Should I fire or promote my agent?)

Features

  • Enterprise-Grade UI Components: 50+ modular components including data grids, charts, editors, navigation, schedulers, and form inputs.
  • Parallax & Motion Suite: High-performance 60fps <Parallax>, viewport <Animate>, and Apple-style <ScrollPin> with zero-config shorthand props. See Parallax Documentation.
  • Responsive Layout Container: Flexible <Container> component supporting full-screen, half-screen, flexbox, CSS grid, and alignment presets. See Container Documentation.
  • Modern Website Sections: Plug-and-play sections including HeroSection, LogoCloud, TestimonialsSection, PricingSection, FAQSection, and CTASection. See Sections Documentation.
  • Full TypeScript Support: Comprehensive type declarations emitted alongside ESM and CommonJS bundles.
  • Universal Theming & Dark Mode: Native light and dark mode out-of-the-box via CSS custom properties and ThemeProvider.
  • Zero Configuration Styling: Bundled standalone style.css with responsive, themeable styling.
  • Accessible (WCAG Compliant): Semantic HTML structure, ARIA attributes, keyboard navigation, and focus management.

Installation

npm install @bloxinine/react-component-library

Note: Ensure react and react-dom (version 18 or 19) are installed in your project.


Quick Start

1. Import Global Styles

Import the component library stylesheet in your application entry file (e.g., main.tsx or App.tsx):

import '@bloxinine/react-component-library/style.css';
import React from 'react';
import { ThemeProvider, Button, Card } from '@bloxinine/react-component-library';
import '@bloxinine/react-component-library/style.css';

export function App() {
  return (
    <ThemeProvider defaultTheme="dark">
      <Card title="Hello React Component Library">
        <p>A modern component library built for enterprise productivity.</p>
        <Button variant="primary" onClick={() => alert('Clicked!')}>
          Get Started
        </Button>
      </Card>
    </ThemeProvider>
  );
}

Documentation

Comprehensive guides, copy-paste examples, and TypeScript props tables for all components:

CategoryGuideComponents Included
📑 Master CatalogComponent DirectoryComplete alphabetical A–Z index & quick-start setup
🌐 Website SectionsWebsite Section SuiteHeroSection, BentoGrid, PricingSection, TestimonialsSection, StatsSection, FAQSection, CTASection, LogoCloud, FooterSection
📐 Layout & ContainerContainer Guide<Container>, <ContainerItem>, fullScreen, halfScreen, flex & grid alignment
🍪 Cookie & PrivacyCookie Policy Guide<CookieConsent>, <CookiePolicyTable>, <CookieSettingsButton>
🚀 Motion SuiteParallax & Motion Guide<Parallax>, <Animate>, <ScrollPin>, useParallax, ParallaxProvider
🧱 Core PrimitivesCore ComponentsButton, Input, Card, Dropdown, Avatar, ProgressBar, Switch, Modal
🧭 NavigationNavigation ComponentsNavbar, AppBar, Sidebar, Breadcrumb, Stepper, Tabs, MenuBar, ContextMenu, SpeedDial, Pager
📝 Forms & InputsForms & InputsTextBox, TextArea, NumericTextBox, MaskedTextBox, Checkbox, RadioButton, Slider, Rating, ColorPicker, DatePicker, TimePicker, DateTimePicker, DateRangePicker, Calendar, Signature, InPlaceEditor, WYSIWYGEditor, ComboBox, AutoComplete, MultiSelect, MultiColumnComboBox, ListBox, SplitButton, ButtonGroup, ProgressButton, Chip/ChipList
📊 Data & ChartsData & ChartsTable, ListView, TreeView, Timeline, GanttChart, LineChart, BarChart, AreaChart, PieChart, DonutChart, ScatterPlot, HeatMap, Sparkline, BulletChart, CircularGauge, LinearGauge, RangeSelector, Barcode/QRCode
💬 Feedback & AIFeedback, Containers & AIDialog, Tooltip, Toast, Badge, Spinner, Skeleton, Accordion, Splitter, Toolbar, Hero, ChatUI, AIAssistView, SmartTextArea, SmartPasteButton

Parallax & Scroll Animations

Easily create visually stunning landing pages with scroll-driven parallax, viewport-triggered animations, and Apple-style pinned scrubbing:

Parallax

Wrap any component or multi-layered scene with <Parallax> inside a <ParallaxProvider>:

import React from 'react';
import { ParallaxProvider, Parallax, Card } from '@bloxinine/react-component-library';

export function ParallaxHero() {
  return (
    <ParallaxProvider>
      <div style={{ position: 'relative', height: '400px', overflow: 'hidden' }}>
        {/* Background layer moves slower */}
        <Parallax speed={-0.2} rotate={[-10, 10]}>
          <img src="/bg-shape.png" alt="Background" style={{ width: '100%', height: 'auto' }} />
        </Parallax>

        {/* Foreground card moves with depth */}
        <Parallax speed={0.35} scale={[0.9, 1.1]}>
          <Card title="Floating Feature Card">
            <p>Parallax depth effects made effortless.</p>
          </Card>
        </Parallax>
      </div>
    </ParallaxProvider>
  );
}

Animate on Scroll In / Scroll Out

The <Animate> component triggers animations as elements enter and exit the viewport:

import React from 'react';
import { Animate, scroll, scrollOut } from '@bloxinine/react-component-library';

export function AnimatedFeatures() {
  return (
    <div>
      {/* 1. Dual in/out prop syntax */}
      <Animate when="scroll" animation="fadeIn" exitAnimation="fadeOut" duration={0.6}>
        <div>Fades in when scrolled into view, fades out when leaving</div>
      </Animate>

      {/* 2. Rules array trigger syntax using typed constants */}
      <Animate
        triggers={[
          { when: scroll, animation: 'scaleIn', duration: 0.5 },
          { when: scrollOut, animation: 'scaleOut', duration: 0.5 }
        ]}
      >
        <div>Scales in on scroll enter, scales out on scroll exit</div>
      </Animate>
    </div>
  );
}

// Supported animations:
// 'fadeIn', 'fadeOut', 'scaleIn', 'scaleOut', 'slideUp', 'slideDown',
// 'slideLeft', 'slideRight', 'zoomIn', 'zoomOut', 'flipIn', 'flipOut',
// 'bounceIn', 'rotateIn', 'rotateOut', 'blurIn', 'pulse', 'shake'
// (Also accepts space-separated aliases like "fade in", "scale out")

ScrollPin (Apple-Style Pinned Scrubbing)

Pin the viewport during scroll to scrub 3D models, hardware renders, or step-by-step disclosures before releasing to the next section:

import React from 'react';
import { ScrollPin } from '@bloxinine/react-component-library';

export function ProductShowcase() {
  return (
    <ScrollPin
      scrollDistance="300vh"
      topOffset="60px"
      pinHeight="calc(100vh - 80px)"
      stepCount={3}
      showProgressBar={true}
    >
      {({ progress, activeStep, isPinned, scrollToStep }) => (
        <div style={{ textAlign: 'center', padding: '2rem' }}>
          <h2>Interactive Showcase ({isPinned ? 'Locked' : 'Unlocked'})</h2>
          <p>Active Step: {activeStep + 1} of 3 | Progress: {(progress * 100).toFixed(0)}%</p>
          <button onClick={() => scrollToStep((activeStep + 1) % 3)}>
            Next Step →
          </button>
        </div>
      )}
    </ScrollPin>
  );
}

Website Sections & Layout

Assemble modern, responsive landing pages with high-level section primitives and flexible container alignment:

import React from 'react';
import { Container, LogoCloud, TestimonialsSection } from '@bloxinine/react-component-library';

export function LandingPage() {
  return (
    <Container display="flex" direction="vertical" gap="4rem">
      {/* Infinite Seamless Logo Marquee */}
      <LogoCloud
        title="Trusted by engineering teams"
        variant="marquee"
        speedSeconds={25}
        logos={[
          { name: 'AcmeCorp', icon: '⚡' },
          { name: 'VentureScale', icon: '🔺' },
          { name: 'NextWave', icon: '🌊' },
          { name: 'ApexCloud', icon: '☁️' }
        ]}
      />

      {/* Infinite Seamless Testimonial Marquee */}
      <TestimonialsSection
        tag="Customer Stories"
        title="Trusted by creators worldwide"
        layout="marquee"
        speedSeconds={35}
        testimonials={[
          {
            quote: "This library completely changed our delivery velocity.",
            author: "Sarah Lin",
            role: "Head of Product",
            company: "VentureScale",
            rating: 5,
            verified: true
          },
          {
            quote: "Production-ready components with zero layout jitter.",
            author: "David Chen",
            role: "Staff Engineer",
            company: "HyperCloud",
            rating: 5,
            verified: true
          }
        ]}
      />
    </Container>
  );
}

Theming & Dark Mode

The library is completely themeable via CSS custom properties. Toggle between light and dark mode simply by applying .dark-theme or using the built-in ThemeProvider:

:root {
  --bg-page: #f8fafc;
  --bg-surface: #ffffff;
  --bg-subtle: #f1f5f9;
  --text-main: #0f172a;
  --text-muted: #64748b;
  --border-main: #e2e8f0;
}

.dark-theme {
  --bg-page: #0b0f17;
  --bg-surface: #151d2c;
  --bg-subtle: #1e293b;
  --text-main: #f8fafc;
  --text-muted: #94a3b8;
  --border-main: #334155;
}

License

MIT © Bloxinine 2026

版本与发布记录

@bloxinine/react-component-library 共发布 26 个版本,首次发布于 2026/10/18;过去 12 个月发布了 26 个版本。

版本发布日期距今
2.0.2latest2026/10/2811 天前
2.0.12026/10/2811 天前
2.0.02026/10/2711 天前
1.5.62026/10/2613 天前
1.5.52026/10/2613 天前
1.5.42026/10/2613 天前

关于 @bloxinine/react-component-library 的常见问题

@bloxinine/react-component-library 是什么?

An AI-slop-generated React component library built with TypeScript (Should I fire or promote my agent?)

如何安装 @bloxinine/react-component-library?

在项目目录运行 npm install @bloxinine/react-component-library,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bloxinine/react-component-library 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bloxinine/react-component-library 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@bloxinine/react-component-library 可以商用吗?

@bloxinine/react-component-library 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bloxinine/react-component-library 的下载量有多少?

根据 npm 官方下载统计,@bloxinine/react-component-library 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,094 次,日均约 136 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bloxinine/react-component-library 还在维护吗?

最新版本 2.0.2 发布于 2026/10/28(11 天前);至今共发布 26 个版本,其中过去 12 个月发布了 26 个;首次发布于 2026/10/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。