thingsboard-ui-vue3

<div align="center">
  <img src="./apps/web-ui/public/logo.svg" alt="ThingsBoard UI Vue3" width="88" />
  <h1>ThingsBoard UI Vue3</h1>
  <p>A Vue 3 management frontend for ThingsBoard, rebuilt on Vben Admin v5.</p>
</div>

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

[![Frontend](https://img.shields.io/badge/frontend-4.4.0-green)](./package.json)
[![ThingsBoard](https://img.shields.io/badge/ThingsBoard-4.4.0-blue)](https://thingsboard.io/)
[![Vben Admin](https://img.shields.io/badge/Vben_Admin-v5-blue)](https://github.com/vbenjs/vue-vben-admin)

## Overview

ThingsBoard UI Vue3 connects a Vue-based administration interface to an existing [ThingsBoard](https://thingsboard.io/) backend. This edition continues with Vben Admin v5, a pnpm workspace, shared components, and antdv-next.

This repository contains the frontend. Run ThingsBoard separately and sign in with an account from your backend. Menus and operations depend on the user's ThingsBoard role and the APIs enabled by that backend.

## Demo site

Address: [https://thingsboard.pincore.cn](https://thingsboard.pincore.cn)

The demo accounts use the ThingsBoard defaults:

| Role | Username | Password |
| --- | --- | --- |
| Tenant administrator | `tenant@thingsboard.org` | `tenant` |
| Customer user | `customer@thingsboard.org` | `customer` |
| System administrator | `sysadmin@thingsboard.org` | `sysadmin` |

These are the [ThingsBoard default credentials](https://thingsboard.io/docs/installation/ubuntu/#step-7-start-thingsboard). For your own installation, tenant/customer demo accounts require demo data; otherwise use the accounts created on your backend.

## Versions and migration

| Component | Version / scope |
| --- | --- |
| ThingsBoard backend | `4.4.0` |
| Administration framework | Vben Admin v5 |
| Application directory | `apps/web-ui` |
| Main branch | `master` |

The frontend package uses the three-part version `4.4.0`; the backend target is `4.4.0`. This README describes the Vben v5 edition. Other backend versions need their own compatibility checks.

When migrating from the previous frontend, use this workspace's environment files and commands. The application has moved from the repository root to `apps/web-ui`. Third-party dependency versions are managed through pnpm Catalog. The old `VITE_PROXY` configuration is replaced by `VITE_TB_TARGET` for local development.

## Features

- **Role-based home pages:** system administrator, tenant administrator, and customer user navigation, summaries, device maps, and API usage views.
- **Entities and profiles:** devices, assets, entity views, device/asset profiles, customer assignments, bulk operations, and device import.
- **Entity details:** attributes, telemetry, events, credentials, calculated fields, and alarm-rule configuration.
- **Tenants and customers:** tenants, tenant profiles, administrators, customers, and customer users.
- **Rule chains:** an AntV X6 graph editor, node configuration forms, and script testing tools.
- **Alarms and no