---
name: arco-design
summary: "Arco Design is a comprehensive React UI component library (60+ components) built on ByteDance's Arco Design system, with strong TypeScript support, extensive theming via design tokens, and a surrounding ecosystem for themes, materials, and icons."
language: TypeScript
license: MIT
repo: https://github.com/arco-design/arco-design
source: https://opensources.dev/resource/arco-design
health: 93
---

# arco-design

Arco Design is a comprehensive React UI component library (60+ components) built on ByteDance's Arco Design system, with strong TypeScript support, extensive theming via design tokens, and a surrounding ecosystem for themes, materials, and icons.

A comprehensive React UI components library based on the [Arco Design](https://arco.design/) system.

[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/arco-design/arco-design/blob/main/LICENSE)
[![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/arco-design/awesome-arco)

English | [简体中文](./README.zh-CN.md)

[https://user-images.githubusercontent.com/19399269/141435899-e453cf75-d50f-4549-b8d0-37daebe46c36.mp4](https://user-images.githubusercontent.com/19399269/141435899-e453cf75-d50f-4549-b8d0-37daebe46c36.mp4)

# Features

## Comprehensive

With more than 60 crafted components that you can use out of the box.

## Customizable theme

Extensive design tokens can be customized to build your own theme. Two ways
of customization are supported:

- [With less-loader](https://arco.design/react/docs/theme)
- [Design Lab](https://arco.design/themes) - Recommended!

## Reusable custom materials

[Material market](https://arco.design/material/) provides a one-stop solution for materials management. Reuse customized modules to make a breakthrough in efficiency.

## TypeScript friendly

All components are written in TypeScript so it's type friendly.

# Installation

Available as an [npm package](https://www.npmjs.com/package/@arco-design/web-react)

```bash
// with npm
npm install @arco-design/web-react

// with yarn
yarn add @arco-design/web-react
```

# Examples

```typescript
import React from 'react';
import ReactDOM from 'react-dom';
import { Button } from '@arco-design/web-react';
import '@arco-design/web-react/dist/css/arco.css';

function App() {
  return (
    <Button type='secondary'>
      Hello World
    </Button>
  );
}

ReactDOM.render(<App />, document.getElementById('app'));
```

# Useful Links

- [Documentation website](https://arco.design/)
- [Components documentation](https://arco.design/react/docs/overview)
- [Dark mode](https://arco.design/react/docs/dark)
- [Theme customization](https://arco.design/react/docs/theme)
- [Figma component library](https://www.figma.com/file/M66cTiLXHa4SVyZIlfY5Pb/arco-Design-System?node-id=7945%3A44563)
- [Awesome Arco](https://github.com/arco-design/awesome-arco)
- [Bundler Plugins](https://github.com/arco-design/arco-plugins)

# Ecosystems

ProjectDescriptionVue Component LibraryA comprehensive Vue UI components library based on the [Arco Design](https://arco.design/) systemDesign LabA platform to create and manage your themes with ease.Material MarketA platform that provides massive high-quality customized materials to greatly boost development efficiency.Icon BoxOne-stop platform to manage your icons.Arco ProA solution to quickly building applications from scratch.

# Browser Support

[](http://godban.github.io/browsers-support-badges/)IE / Edge[](http://godban.github.io/browsers-support-badges/)Firefox[](http://godban.github.io/browsers-support-badges/)Chrome[](http://godban.github.io/browsers-support-badges/)Safari[](http://godban.github.io/browsers-support-badges/)Opera[](http://godban.github.io/browsers-support-badges/)ElectronEdge 1631493136last 2 versions

# Contributing

Developers interested in contributing should read the [Code of Conduct](./CODE_OF_CONDUCT.md) and the [Contributing Guide](./CONTRIBUTING.md).

Thank you to all the people who already contributed to ArcoDesign!

# License

This project is [MIT licensed](./LICENSE).