Skip to content

Commit fccbbe3

Browse files
docs: add readme
1 parent a17ccfa commit fccbbe3

File tree

1 file changed

+9
-42
lines changed

1 file changed

+9
-42
lines changed

README.md

Lines changed: 9 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,18 @@
1-
# AdminBro Addon template
1+
# Koa plugin for AdminBro
22

3-
This an AdminBro addon template repository. You may use it if you want to create
3+
This is an official [AdminBro](https://github.com/SoftwareBrothers/admin-bro) plugin which integrates it to [nestjs](https://nestjs.com) framework.
44

5-
* AdminBro plugin
6-
* AdminBro adapter
7-
* AdminBro feature
5+
## AdminBro
86

9-
## What is inside
7+
AdminBro is an automatic admin interface which can be plugged into your application. You, as a developer, provide database models (like posts, comments, stores, products or whatever else your application uses), and AdminBro generates UI which allows you (or other trusted users) to manage content.
108

11-
It is a typescript repository with:
9+
Check out the example application with mongo and postgres models here: https://admin-bro-example-app-staging.herokuapp.com/admin
1210

13-
* TypeScript
14-
* linter with semantic commits (ensures the same style across AdminBro packages)
15-
* semantic-release
16-
* github actions
17-
* example application with cypress
11+
Or visit [AdminBro](https://github.com/SoftwareBrothers/admin-bro) github page.
1812

19-
What is missing:
20-
* cypress run in the CI which is an optional. You can take a look at admin-bro/core repository to see how to build it.
13+
## Usage
2114

22-
## How to use it
23-
24-
In order to start working on an AdminBro feature/plugin/adapter follow this steps:
25-
26-
1. fork this repository
27-
2. Make sure it uses the latest versions of the packages
28-
2. rename package in package.json
29-
3. add env variables github settings:
30-
- SLACK_WEBHOOK
31-
- NPM_TOKEN
32-
4. in the root folder:
33-
- `yarn install`
34-
- `yarn link` (registers package in `linked packages` repository)
35-
5. cd example-app
36-
- `yarn install`
37-
- `yarn add NAME_OF_YOUR_PACKAGE`
38-
- `yarn link NAME_OF_YOUR_PACKAGE`
39-
6. then in one terminal in the root folder run:
40-
- `yarn build --watch`
41-
7. in the second terminal in example app:
42-
- `yarn dev`
43-
44-
You can read more about package linking in [yarn link documentation](https://classic.yarnpkg.com/en/docs/cli/link/)
45-
46-
## Publishing to NPM
47-
48-
package has semantic-release configured, but it don't upload build to NPM because of `private: true` set in package.json. In order to trigger automatic releases simply remove this line.
15+
To see example usage see the [example-app](https://github.com/SoftwareBrothers/admin-bro-nestjs/tree/master/example-app) or visit the [Nestjs section under AdminBro project page](https://softwarebrothers.github.io/admin-bro-dev/module-admin-bro-nest.html)
4916

5017
## License
5118

@@ -58,4 +25,4 @@ AdminBro is Copyright © 2020 SoftwareBrothers.co. It is free software, and may
5825
We’re an open, friendly team that helps clients from all over the world to transform their businesses and create astonishing products.
5926

6027
* We are available for [hire](https://softwarebrothers.co/contact).
61-
* If you want to work for us - checkout the [career page](https://softwarebrothers.co/career).
28+
* If you want to work for us - checkout the [career page](https://softwarebrothers.co/career).

0 commit comments

Comments
 (0)