Skip to content
8bitcn logo

8bitcn/ui

基于 shadcn/ui 与 Tailwind CSS 构建的复古 8-Bit 像素风 React 组件库,兼备像素艺术美学与现代 WAI-ARIA 无障碍标准。

8bitcn 官方界面预览

项目概述

8bitcn(8bitcn/ui)是由 TheOrcDev 开发并开源的复古像素风格(8-Bit / Retro Style)React 组件库。项目完全基于 shadcn/ui 架构与 Tailwind CSS 构建,将 80/90 年代经典的红白机、街机与像素游戏视觉语言,与现代化 Web 的无障碍(Accessibility)标准深度融合。8bitcn 遵循 Copy-and-Paste 代码所有权模式,让独立开发者、游戏开发者和创意工作室能够以零学习成本将充满怀旧复古感的像素按钮、像素卡片、血条进度条和游戏级区块快速装配到 React 项目中。

核心特性

  • 👾 纯正复古 8-Bit 像素美学:精心重构了像素化边框阴影、经典按压位移微动效、像素字体与复古高对比调色盘,完美还原街机与像素游戏视效。
  • 🧱 全面兼容 shadcn/ui 生态:依托 shadcn Registry 规范,采用相同的设计哲学与 CLI 命令,安装即复制纯净源码,不引入不可控的打包依赖。
  • ♿️ 现代 Web 无障碍标准保驾护航:外表复古硬核,内核现代标准。所有组件底层均严格遵循 WAI-ARIA 无障碍规范,完整支持键盘焦点导航与屏幕阅读器。
  • 🎮 开箱即用的游戏级区块(Blocks):提供生命值/法力条(Health/Mana Bars)、复古弹窗(Dialogs)、像素徽章、角色状态卡片等 35+ 款高频复古 UI 预设。

快速上手与示例代码

# 通过 shadcn CLI 直接安装 8-bit 经典像素按钮
pnpm dlx shadcn@latest add @8bitcn/button

# 或按需添加像素卡片与徽章组件
pnpm dlx shadcn@latest add @8bitcn/card @8bitcn/badge
import React from 'react';
import { Button } from '@/components/ui/8bit/button';
import { Card, CardHeader, CardTitle, CardContent } from '@/components/ui/8bit/card';
import { Badge } from '@/components/ui/8bit/badge';

export function RetroGameLobby() {
  return (
    <Card className="max-w-md mx-auto p-4 retro-border">
      <CardHeader>
        <div className="flex items-center justify-between">
          <CardTitle className="text-xl font-mono">PLAYER STATUS</CardTitle>
          <Badge variant="destructive">LEVEL 99</Badge>
        </div>
      </CardHeader>
      <CardContent className="space-y-4 font-mono text-sm">
        <p>HP: [██████████] 100/100</p>
        <Button variant="default" className="w-full">
          START QUEST
        </Button>
      </CardContent>
    </Card>
  );
}

技术选型建议与适用场景

  • 非常适合:Web3 与链游落地页、游戏化学习平台、极客个人主页与技术博客、游戏社区论坛、复古活动营销页以及任何需要强烈视觉记忆点的数字产品。
  • 与同类方案对比:以往想要实现像素风往往需要手写大量粗糙的 CSS 或引入过时的老旧框架,而 8bitcn 站在了现代 shadcn/ui 的巨人肩膀上,不仅视觉出众,工程底座与 TypeScript 类型支持也极其扎实。

讨论与评价

0 条讨论
分享你对该组件库的上手体验、优缺点或建议...

暂无讨论。欢迎分享你对该组件库的上手体验、优缺点或建议!

相关组件推荐

基于同类与技术栈推荐