You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+23-30Lines changed: 23 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,60 +4,55 @@ We want this community to be friendly and respectful to each other. Please follo
4
4
5
5
## Development Workflow
6
6
7
-
To get started with the project, make sure you have a local instance of Strapi running.
8
-
See the [Strapi docs](https://github.com/strapi/strapi#getting-started) on how to setup a Strapi project.
7
+
This plugin provides a local development instance of Strapi to develop it's features. We call this instance `playground` and it can be found in the playground folder in the root of the project. For that reason it is not needed to have your own Strapi instance running to work on this plugin. Just clone the repo and you're ready to go!
9
8
10
-
#### 1. Fork the [repository](https://github.com/boazpoolman/strapi-plugin-config-sync)
9
+
#### 1. Fork the [repository](https://github.com/pluginpal/strapi-plugin-config-sync)
11
10
12
-
[Go to the repository](https://github.com/boazpoolman/strapi-plugin-config-sync) and fork it to your own GitHub account.
11
+
[Go to the repository](https://github.com/pluginpal/strapi-plugin-config-sync) and fork it to your own GitHub account.
13
12
14
-
#### 2. Clone from your repository into the plugins folder
Rebuild your strapi project to build the admin part of the plugin.
37
+
We use `yalc`to publish the package to a local registry. Run the following command o watch for changes and push to `yalc` every time a change is made:
47
38
48
39
```bash
49
-
cd YOUR_STRAPI_PROJECT &&yarn build
40
+
yarn develop
50
41
```
51
42
52
-
#### 6. Running the administration panel in development mode
43
+
#### 6. Start the playground instance
53
44
54
-
**Start the administration panel server for development**
45
+
Leave the watcher running, open up a new terminal window and browse back to the root of the plugin repo. Run the following command:
55
46
56
47
```bash
57
-
cd YOUR_STRAPI_PROJECT &&yarn develop --watch-admin
48
+
yarn playground:develop
58
49
```
59
50
60
-
The administration panel will be available at http://localhost:8080/admin
51
+
This will start the playground instance that will have the plugin installed from the `yalc` registry. Browse to http://localhost:1337 and create a test admin user to log in to the playground.
52
+
53
+
#### 7. Start your contribution!
54
+
55
+
You can now start working on your contribution. If you had trouble setting up this testing environment please feel free to report an issue on Github.
61
56
62
57
### Commit message convention
63
58
@@ -82,12 +77,10 @@ The `package.json` file contains various scripts for common tasks:
82
77
83
78
-`yarn eslint`: lint files with ESLint.
84
79
-`yarn eslint:fix`: auto-fix ESLint issues.
85
-
-`yarn test:unit`: run unit tests with Jest.
80
+
-`yarn test:integration`: run integration tests with Jest.
86
81
87
82
### Sending a pull request
88
83
89
-
> **Working on your first pull request?** You can learn how from this _free_ series: [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
90
-
91
84
When you're sending a pull request:
92
85
93
86
- Prefer small pull requests focused on one change.
0 commit comments