Peacock

The foundation for beautiful user interfaces.

Peacock gives you the tools and foundation to build beautiful, usable product interfaces. It’s the system you use to craft your own component library.

What is Peacock?

Peacock is more than just a collection of components; it is an aesthetic philosophy. Like its avian namesake, it provides the core elements (the primitives) that allow the full, vibrant display (the design) to be unveiled.

Opinionated Beauty: We deliver pre-styled, beautiful components that follow modern design trends, significantly reducing the boilerplate needed to achieve a professional look.

Foundation First: Similar to projects like shadcn/ui, Peacock focuses on providing the foundational primitives, ensuring maximum flexibility for customization without sacrificing initial polish.

Seamless Integration: Designed with modern web frameworks in mind (e.g., React, Vue), integrating Peacock into your existing project structure is fast, efficient, and empowering.

Key Features

Vibrant & Consistent Design System: Every component—from buttons and cards to complex data tables—shares a cohesive, high-quality visual language.

Highly Extensible: The component structure is designed for easy overwriting and theme customization, allowing you to quickly adapt the style to your specific brand identity.

Built for Accessibility: Focus on semantic HTML and proper ARIA attributes to ensure that your beautiful interfaces are accessible to all users.

Responsive by Default: Components are built with responsiveness baked in, guaranteeing a graceful display across all screen sizes and devices.

Documentation

Visit https://peacock.redvars.com to view the documentation.

Getting Started

<head>
  
   <!-- Default font : Noto Sans and Noto Sans Mono -->
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+Mono:[email protected]&family=Noto+Sans:ital,wght@0,100..900;1,100..900&display=swap" rel="stylesheet">

  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@redvars/[email protected]/dist/assets/styles.css"></link>
  <script type='module'
          src='https://cdn.jsdelivr.net/npm/@redvars/[email protected]/dist/loader.js'></script>
</head>

<wc-button>Button</wc-button>

Icons without the CDN

loader.js fetches icons from cdn.jsdelivr.net. For a page that must stay on its own origin, such as an intranet or a page whose content security policy allows only connect-src 'self', serve the package's dist/ folder yourself and load loader-full.js instead. It loads the same components, and fetches Material Symbols from the copy it ships in dist/icons/material-symbols/:

<script type='module' src='/assets/peacock/dist/loader-full.js'></script>

To keep icons somewhere else, call setIconBase('material-symbols', '/my/icons/') before the first icon renders; the folder holds one <name>.svg per icon.

Components

• 🟢 ready (feature complete for now)
• 🟡 beta (changes possible, not feature complete)
• 🔴 not ready (unstyled / no functions)
• 🔵 planned (created, but empty files)

Input Controls

Input controls are UI design elements that allow users to input information into the system. They are essential for collecting data and enabling user interactions. Some common examples of input controls include text fields, dropdown menus, checkboxes, and radio buttons.

Name	Component	State
Checkbox	wc-checkbox	🟢
Code editor	wc-code-editor	🟢
Color picker	wc-color-picker	🟡
Date picker	wc-date-picker	🟡
Date time picker	datetime-picker	🔴
Field / Form control	wc-field	🟡
File picker	file-picker	🔴
HTML editor	wc-html-editor	🟡
Input	wc-input	🟢
Input URL	input-url	🔴
Month picker	month-picker	🔴
Number field	wc-number-field	🟢
Radio	wc-radio	🟢
Search	wc-search	🟡
Select

Navigation

Navigational components are UI elements that help users move around the app or website. They provide users with a clear and intuitive way to navigate through different sections and pages. Some common examples of navigational components include menus, tabs, and breadcrumbs.

Name	Component	State
Breadcrumb	wc-breadcrumb	🟢
Dropdown	wc-dropdown	🔴
Menu	wc-menu	🟡
Tabs	wc-tabs	🟢
Toolbar	wc-toolbar	🟡

Informational

Informational components are UI elements that provide information to users. They communicate important messages, updates, or instructions within the app or website. Some common examples of informational components include notifications, tooltips, and progress bars.

Name	Component	State
Badge	wc-badge	🟢
Alert	wc-alert	🟡
Circular Progress	wc-circular-progress	🟢
Linear Progress	wc-linear-progress	🟢
Notification	wc-notification	🟢
Skeleton	wc-skeleton	🟢
Snackbar	wc-snackbar	🟡
Spinner	wc-spinner	🟢
Tooltip	wc-tooltip	🟢

Containers

Containers are UI elements that group similar content together, making it easier for users to navigate and scan through the interface. Examples of common containers include cards, carousels, and accordions, which provide structure and organization to the content.

Name	Component	State
Accordion	wc-accordion	🟢
Bottom Sheet	wc-bottom-sheet	🟡
Card	wc-card	🟢
Container	wc-container	🟡
Side Sheet	wc-side-sheet	🟡

General

These components are used for general purpose. They include

Name	Component	State
Avatar	wc-avatar	🟢
Button	wc-button	🟢
Button Group	wc-button-group	🟢
Calendar	calendar	🔴
Card Select	card-select	🔴
Chip	wc-chip	🟢
Clock	wc-clock	🟡
Code Highlighter	wc-code-highlighter	🟢
Divider	wc-divider	🟢
Empty State	wc-empty-state	🟡
FAB	wc-fab	🟢
Flow Designer	flow-designer	🔵
Header	header	🔴
Icon	wc-icon	🟢

Charts

These components are used to display data in a graphical format. They include

Name	Component	State
Bar Chart	wc-chart-bar	🟢
Doughnut Chart	wc-chart-doughnut	🟢
Pie Chart	wc-chart-pie	🟢
Stacked Bar Chart	wc-chart-stacked-bar	🟢

📄 License

Peacock is open-source software licensed under the Apache-2.0 License.

---

Made with 💖 by Redvars.