Skip to content

Commit 5a5e912

Browse files
authored
chore: update readme (opentiny#1444)
1 parent fbbfaa8 commit 5a5e912

4 files changed

Lines changed: 225 additions & 88 deletions

File tree

README.md

Lines changed: 45 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
</a>
55
</p>
66

7-
<p align="center">TinyEngine enables developers to customize low-code platforms, build low-bit platforms online in real time, and support secondary development or integration of low-bit platform capabilities.</p>
7+
<p align="center">TinyEngine enables developers to customize low-code platforms, build low-code platforms online in real time, and support secondary development or integration of low-code platform capabilities.</p>
88

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

@@ -15,38 +15,52 @@ English | [简体中文](README.zh-CN.md)
1515
- Directly generate deployable source code without engine support.
1616
- Allows access to third-party components and customized extension plug-ins.
1717
- Supports high-code and low-code, and hybrid development and deployment of applications.
18-
- The platform accesses AI big model capabilities to help developers build applications.
18+
- The platform accesses LLM capabilities to help developers build applications.
1919

2020
## Documentation
2121

2222
- intro:https://opentiny.design/tiny-engine#/home
23-
- tutorial:https://opentiny.design/tiny-engine#/help-center/course/engine
23+
- tutorial:https://opentiny.design/tiny-engine#/help-center/index
2424
- playground:https://opentiny.design/tiny-engine#/tiny-engine-editor
2525

26-
## Development
26+
## Usage
2727

28-
### Dependencies required for installation
28+
### Environment Setup
29+
30+
- Install Node.js 18+
31+
32+
- Install pnpm 9+
33+
34+
```sh
35+
$ npm install -g pnpm
36+
```
37+
38+
### Create Low-Code Platform using CLI
2939

3040
```sh
41+
# Create low-code platform
42+
$ npx @opentiny/engine-cli create-platform <name>
43+
# Enter the low-code platform directory
44+
$ cd <name>
45+
# Install dependencies
3146
$ pnpm install
3247
```
3348

3449
### Local development: Start the local mock server and use the mock data of the local mock server.
3550

51+
> The mock server included with the created low-code platform only provides basic backend mock functionality. If you need to experience the complete backend service capabilities, please refer to the Java backend startup instructions below.
52+
3653
```sh
3754
$ pnpm dev
3855
```
3956

40-
## Local development, directly connected to the local tiny-engine-webservice server
41-
42-
1. Start <a href="https://github.com/opentiny/tiny-engine-data-center/blob/main/README.md" target="_blank">tiny-engine-data-center</a>
57+
### Local Development with Java Backend
4358

44-
2. Start <a href="https://github.com/opentiny/tiny-engine-webservice/blob/main/README.md" target="_blank">tiny-engine-webservice</a>
59+
Java backend repository: https://github.com/opentiny/tiny-engine-backend-java
4560

46-
3. Modify the origin value in `vite.config.js` in the `packages/design-core/` directory of the tiny-engine project to be the address port of your local webService project (the webService port defaults to 7011), such as:
47-
48-
<img alt="Modify port" src="https://res.hc-cdn.com/lowcode-portal/1.1.55/img/docimg/backend_deploy_5.png">
61+
Start Java backend for frontend-backend integration:
4962

63+
[Frontend-Backend Integration Documentation](https://opentiny.design/tiny-engine#/help-center/course/dev/debugging-of-java-backend)
5064

5165
### Materials Synchronization [Solution](https://opentiny.design/tiny-engine#/help-center/course/dev/material-sync-solution)
5266

@@ -58,7 +72,7 @@ $ pnpm splitMaterials
5872
$ pnpm buildMaterials
5973
```
6074

61-
Open a browser: `http://localhost:8080/?type=app&id=1&tenant=1&pageid=NTJ4MjvqoVj8OVsc`
75+
Open a browser: `http://localhost:8080/?type=app&id=1&tenant=1&pageid=1`
6276
`url search` Parameters:
6377

6478
- `type=app` Application type
@@ -69,16 +83,8 @@ Open a browser: `http://localhost:8080/?type=app&id=1&tenant=1&pageid=NTJ4MjvqoV
6983
## Build
7084

7185
```sh
72-
# Build all plug-ins first
73-
pnpm build:plugin
74-
7586
# Build Designer
76-
pnpm build:alpha or build:prod
77-
78-
```
79-
The folder where the product is located after building
80-
```
81-
tiny-engine/packages/design-core/dist/
87+
pnpm run build:alpha or build:prod
8288
```
8389

8490
## Milestones
@@ -91,7 +97,12 @@ axisFormat %Y-%m-%d
9197
1.0.0-beta.x version : 2023-09-25, 2024-05-20
9298
1.0.0-rc version(refactor version) : 2024-10-01
9399
1.0.0 version : 2024-11-01
94-
100+
2.0.0 version : 2024-12-16
101+
2.1.0 version : 2025-01-02
102+
2.2.0 version : 2025-02-19
103+
2.3.0 version : 2025-03-14
104+
2.4.0 version : 2025-04-07
105+
2.5.0 version : 2025-05-15
95106
```
96107

97108
## 🤝 Participation and Contribution
@@ -103,6 +114,16 @@ Please read the [Contribution Guide](CONTRIBUTING.md) before participating in th
103114
- Add official assistant WeChat opentiny-official and join the technical exchange group
104115
- Join the mailing list opentiny@googlegroups.com
105116

117+
## ❤️ Acknowledgments
118+
119+
Thanks to all the developers who have contributed to TinyEngine!
120+
121+
<p align="center">
122+
<a href="https://github.com/opentiny/tiny-engine/graphs/contributors" target="_blank">
123+
<img alt="Contributors" src="https://contrib.rocks/image?repo=opentiny/tiny-engine">
124+
</a>
125+
</p>
126+
106127
## License
107128

108-
[MIT](LICENSE)
129+
[MIT](LICENSE)

README.zh-CN.md

Lines changed: 42 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -20,33 +20,47 @@
2020
## 文档
2121

2222
- 介绍:https://opentiny.design/tiny-engine#/home
23-
- 使用文档:https://opentiny.design/tiny-engine#/help-center/course/engine
23+
- 使用文档:https://opentiny.design/tiny-engine#/help-center/index
2424
- 演示应用:https://opentiny.design/tiny-engine#/tiny-engine-editor
2525

26-
## 开发
26+
## 使用
2727

28-
### 安装所需的依赖
28+
### 环境准备
29+
30+
- 安装 Node.js 18+
31+
32+
- 安装 pnpm 9+
33+
34+
```sh
35+
$ npm install -g pnpm
36+
```
37+
38+
### 使用 cli 创建低代码平台
2939

3040
```sh
41+
# 创建低代码平台
42+
$ npx @opentiny/engine-cli create-platform <name>
43+
# 进入低代码平台
44+
$ cd <name>
45+
# 安装依赖
3146
$ pnpm install
3247
```
3348

3449
### 本地开发,启动本地 mock 服务器,使用本地 mock 服务器的 mock 数据
3550

51+
> 创建低代码平台后自带的 mock Server 仅包含简单的后端 mock 功能,如果需要体验完整的后端服务能力,请参考下文启动 java 服务端。
52+
3653
```sh
3754
$ pnpm dev
3855
```
3956

40-
### 本地开发,直连本地的tiny-engine-webservice服务端
41-
42-
1. 启动 <a href="https://github.com/opentiny/tiny-engine-data-center/blob/main/README.md" target="_blank">tiny-engine-data-center</a>
57+
### 本地开发,启动 Java 服务端
4358

44-
2. 启动 <a href="https://github.com/opentiny/tiny-engine-webservice/blob/main/README.md" target="_blank">tiny-engine-webservice</a>
59+
java 服务端代码仓库:https://github.com/opentiny/tiny-engine-backend-java
4560

46-
3. 修改 tiny-engine 项目 `packages/design-core/` 目录下 `vite.config.js` 中origin的值为自己本地webService项目的地址端口(webService端口默认为7011),如:
47-
48-
<img alt="修改端口" src="https://res.hc-cdn.com/lowcode-portal/1.1.55/img/docimg/backend_deploy_5.png">
61+
启动 Java 服务端进行前后端联调:
4962

63+
[前后端联调文档](https://opentiny.design/tiny-engine#/help-center/course/dev/debugging-of-java-backend)
5064

5165
### 物料同步[方案](https://opentiny.design/tiny-engine#/help-center/course/dev/material-sync-solution)
5266

@@ -58,7 +72,7 @@ $ pnpm splitMaterials
5872
$ pnpm buildMaterials
5973
```
6074

61-
浏览器打开:`http://localhost:8080/?type=app&id=1&tenant=1&pageid=NTJ4MjvqoVj8OVsc`
75+
浏览器打开:`http://localhost:8080/?type=app&id=1&tenant=1&pageid=1`
6276
`url search`参数:
6377

6478
- `type=app` 应用类型
@@ -69,16 +83,8 @@ $ pnpm buildMaterials
6983
## 构建
7084

7185
```sh
72-
# 先构建所有插件
73-
pnpm run build:plugin
74-
7586
# 构建设计器
7687
pnpm run build:alpha 或 build:prod
77-
78-
```
79-
构建后产物所在文件夹
80-
```
81-
tiny-engine/packages/design-core/dist/
8288
```
8389

8490
## 里程碑
@@ -91,7 +97,12 @@ axisFormat %Y-%m-%d
9197
1.0.0-beta.x version : 2023-09-25, 2024-05-20
9298
1.0.0-rc version(refactor version) : 2024-10-01
9399
1.0.0 version : 2024-11-01
94-
100+
2.0.0 version : 2024-12-16
101+
2.1.0 version : 2025-01-02
102+
2.2.0 version : 2025-02-19
103+
2.3.0 version : 2025-03-14
104+
2.4.0 version : 2025-04-07
105+
2.5.0 version : 2025-05-15
95106
```
96107

97108
## 🤝 参与贡献
@@ -103,6 +114,16 @@ axisFormat %Y-%m-%d
103114
- 添加官方小助手微信 opentiny-official,加入技术交流群
104115
- 加入邮件列表 opentiny@googlegroups.com
105116

117+
## ❤️ 致谢
118+
119+
感谢所有为 TinyEngine 做出贡献的开发者们!
120+
121+
<p align="center">
122+
<a href="https://github.com/opentiny/tiny-engine/graphs/contributors" target="_blank">
123+
<img alt="贡献者" src="https://contrib.rocks/image?repo=opentiny/tiny-engine">
124+
</a>
125+
</p>
126+
106127
## 开源协议
107128

108-
[MIT](LICENSE)
129+
[MIT](LICENSE)

logo.svg

Lines changed: 9 additions & 43 deletions
Loading

0 commit comments

Comments
 (0)