# Open supOS frontend

**Repository Path**: Hanabi04/supos-ce-frontend

## Basic Information

- **Project Name**: Open supOS frontend
- **Description**: Open supOS 前端项目

技术栈
TypeScript: 添加静态类型的 JavaScript 超集。
Vite: 一个快速的开发服务器和构建工具。
React: 用于构建用户界面的 JavaScript 库。
pnpm: 一个快速、节省磁盘空间的软件包管理器。
- **Primary Language**: NodeJS
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2026-09-22
- **Last Updated**: 2026-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[English][readme-en-link] | **简体中文**

# supOS

supOS 是一个开源的工业物联网 (IIoT) 平台。

## 技术栈

- **TypeScript**: 添加静态类型的 JavaScript 超集。
- **Vite**: 一个快速的开发服务器和构建工具。
- **React**: 用于构建用户界面的 JavaScript 库。
- **pnpm**: 一个快速、节省磁盘空间的软件包管理器。

### 依赖

确保您已安装以下内容：

- [Node.js](https://nodejs.org/) (version 18 or later)
- [pnpm](https://pnpm.io) (version 8 or later)
- [vite](https://vite.dev/)

### 安装

1. 复制仓库地址:

   ```bash
   git clone https://github.com/supOS-Project/supOS-frontend.git
   ```

2. 安装依赖:

   ```bash
   pnpm install

   ```

3. 开发:
   ```bash
   pnpm start
   ```
4. 生产构建:
   ```bash
   pnpm build
   ```

### 本地 nginx 容器部署

初始化依赖使用:

```bash
pnpm install
```

轻量构建并更新到本地 nginx 容器挂载的前端目录:

```bash
pnpm run init
```

该命令会执行本地 nginx 开发构建，直接输出到 `/volumes/supos/data/frontend/frontend-build`，然后重载 nginx 并验证 `http://localhost:8088/`。

频繁调试时可以使用 watch 模式，文件变更后自动重新构建到 nginx 目录:

```bash
pnpm run build:nginx:watch
```

如需确认 nginx 容器挂载目录:

```bash
wsl -e sh -lc "docker inspect nginx --format '{{json .Mounts}}'"
```

备份当前部署产物:

```bash
wsl -e sh -lc 'ts=$(date +%Y%m%d%H%M%S); tar -C /volumes/supos/data/frontend -czf /tmp/frontend-build-backup-${ts}.tgz frontend-build'
```

同步新的构建产物到 nginx 使用的宿主机挂载目录:

```bash
wsl -e sh -lc 'rsync -a --delete /mnt/e/code/gitee-workspace/supos-ce-frontend/build/ /volumes/supos/data/frontend/frontend-build/'
```

重载 nginx:

```bash
wsl -e sh -lc "docker exec nginx nginx -s reload"
```

验证服务:

```bash
wsl -e sh -lc "curl -sSI http://localhost:8088/ | sed -n '1,20p'"
```

如果项目路径不在 `E:\code\gitee-workspace\supos-ce-frontend`，需要把同步命令里的 `/mnt/e/code/gitee-workspace/supos-ce-frontend/build/` 替换为实际 WSL 路径。

5. 跳过版本

```bash
git merge release/20241106-f-iteration -m "feat: 合并 feature-branch 到 master，skip-version"
```

## 开发规范

[规范][readme-spec-link]
[导航][shepherd-link]

## 许可证

本项目采用 Apache License 2.0 许可证 - 查看 [LICENSE](./LICENSE) 文件了解详情。

<!-- Links -->

[readme-en-link]: ./README.md
[readme-zh-link]: ./README-zh.md
[readme-spec-link]: ./docs/dev-spec.md
[shepherd-link]: ./docs/component/shepherd.md