2021-03-29 13:07:09 +08:00
English | [简体中文 ](./README.zh-CN.md )
2021-09-28 13:02:14 +08:00
![](https://www.nocobase.com/images/demo/11.png)
2021-02-24 21:18:33 +08:00
What is NocoBase
----------
2021-10-20 11:39:36 +08:00
NocoBase is a scalability-first, open-source no-code development platform. No programming required, build your own collaboration platform, management system with NocoBase in minutes.
2021-02-24 21:18:33 +08:00
2021-10-14 11:02:15 +08:00
When to use NocoBase
2021-02-24 21:18:33 +08:00
----------
2021-02-24 21:25:13 +08:00
- **SMEs and organizations build business platforms and management systems for themselves or for their industry**
2021-02-24 21:18:33 +08:00
- Want the price to be low enough or even free
- Can be flexibly customized without programming knowledge
- Need full control of source code and data
- Can freely distribute and sell as their own products
2021-02-24 21:25:13 +08:00
- **Service providers and outsourcing teams develop collaboration platforms and management systems for their clients**
2021-02-24 21:18:33 +08:00
- Want to keep development costs as low as possible
- Need the most user-friendly secondary development experience
- Must be deployed privately as a standalone product for the client
- Can be freely distributed and sold by the client
Why choose NocoBase
----------
2021-02-24 21:25:13 +08:00
- **Open source and free**
2021-02-24 21:18:33 +08:00
- Unrestricted commercial use under the MIT license
- Full code ownership, private deployment, private and secure data
- Free to expand and develop for actual needs
- Good ecological support
2021-02-24 21:25:13 +08:00
- **Strong no-code capability**
2021-09-28 13:02:14 +08:00
- WYSIWYG visual configuration
- Separation of data structure configuration from interface configuration
- Rich combination of blocks and operations
- Role-based access control
2021-02-24 21:25:13 +08:00
- **Developer-friendly**
2021-02-24 21:18:33 +08:00
- Microkernel architecture, flexible and easy to extend, with a robust plug-in system
2021-09-28 13:02:14 +08:00
- Node.js-based, with popular frameworks and technologies, including Koa, Sequelize, React, Formily, Ant Design, etc.
2021-04-04 23:33:06 +08:00
- Progressive development, easy for getting-started, friendly to newcomers
- No binding, no strong dependencies, can be used in any combination or extensions, can be used in existing projects
2020-11-11 15:23:39 +08:00
2021-10-20 11:39:36 +08:00
Note
----------
NocoBase is still in early development and is for preview purposes only and is not suitable for use in a production environment. A relatively stable and well-documented public beta is expected to be released as early as the first quarter of 2022.
If you are interested in NocoBase, please join us to discuss and develop it together.
https://www.nocobase.com/
hello@nocobase.com
2021-03-29 13:21:35 +08:00
Architecture
----------
2021-09-28 13:02:14 +08:00
![](https://docs.nocobase.com/static/NocoBase.c9542b1f.png)
2021-03-29 13:21:35 +08:00
2021-03-30 20:27:01 +08:00
Requirements
2020-11-11 15:23:39 +08:00
----------
2021-03-30 20:27:01 +08:00
Node:
2020-11-11 15:23:39 +08:00
2021-10-07 18:01:45 +08:00
- Node.js 12.20+
2020-11-11 15:23:39 +08:00
2021-10-07 18:01:45 +08:00
Database:
2020-11-11 15:23:39 +08:00
2021-10-07 18:01:45 +08:00
- PostgreSQL 10.x+
2021-10-18 12:49:37 +08:00
- Sqlite 3+
2021-03-30 20:27:01 +08:00
Installation
----------
2020-11-11 15:23:39 +08:00
2021-10-08 00:32:40 +08:00
### Create a project with `create-nocobase-app`
2021-04-07 20:34:30 +08:00
2021-10-18 12:49:37 +08:00
#### Quickstart
2020-11-11 15:23:39 +08:00
~~~shell
2021-10-18 12:49:37 +08:00
yarn create nocobase-app my-nocobase-app --quickstart
~~~
2021-10-25 14:47:28 +08:00
#### Step by step
2021-10-18 12:49:37 +08:00
~~~shell
# 1. create project
yarn create nocobase-app my-nocobase-app
2021-10-25 14:24:24 +08:00
# 2. switch to the project directory
cd my-nocobase-app
2021-10-18 12:49:37 +08:00
2021-10-25 14:24:24 +08:00
# 3. create initialization data
2021-10-18 12:49:37 +08:00
yarn nocobase init --import-demo
2021-10-25 14:24:24 +08:00
# 4. start project
2021-10-07 18:01:45 +08:00
yarn start
2020-11-11 15:23:39 +08:00
~~~
2021-10-08 00:32:40 +08:00
Open http://localhost:8000 in a web browser.
### Use docker compose
Create a `docker-compose.yml` file
```yaml
version: "3"
networks:
nocobase:
driver: bridge
services:
adminer:
image: adminer
restart: always
networks:
- nocobase
ports:
- 28080:8080
postgres:
image: postgres:10
restart: always
networks:
- nocobase
command: postgres -c wal_level=logical
environment:
POSTGRES_USER: nocobase
POSTGRES_DB: nocobase
POSTGRES_PASSWORD: nocobase
nocobase:
image: nocobase/nocobase:0.5.0-alpha.14
networks:
- nocobase
command: [ "yarn", "serve", "start", "--port", "8000" ]
environment:
DB_DIALECT: postgres
DB_DATABASE: nocobase
DB_USER: nocobase
DB_PASSWORD: nocobase
DB_PORT: 5432
DB_HOST: postgres
ports:
- "28000:8000"
```
Run the command on your terminal
```
docker-compose run nocobase bash -c 'yarn serve init'
docker-compose up -d
```
Open http://localhost:28000 in a web browser.
### Participate in the development
2021-04-17 22:47:08 +08:00
2021-10-07 18:01:45 +08:00
~~~shell
2021-04-17 22:47:08 +08:00
git clone https://github.com/nocobase/nocobase.git
cd nocobase
2021-10-08 00:32:40 +08:00
cp .env.example .env
docker-compose up -d postgres
2021-10-07 18:01:45 +08:00
yarn install
2021-10-10 12:16:28 +08:00
yarn bootstrap
yarn build
yarn nocobase init
2021-10-07 18:01:45 +08:00
yarn start
2020-11-11 15:23:39 +08:00
~~~
2021-10-08 00:32:40 +08:00
2021-10-14 11:02:15 +08:00
Open http://localhost:8000 in a web browser.