mirror of
https://gitlab.com/openstapps/openstapps.git
synced 2026-01-21 00:52:55 +00:00
28
README.md
28
README.md
@@ -5,9 +5,11 @@
|
||||
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
|
||||
[](https://openstapps.gitlab.io/configuration)
|
||||
|
||||
A collection of configuration base files for StApps projects.
|
||||
Checks your `@openstapps` project's configuration and automatically adjusts it to adhere to the suggested defaults.
|
||||
|
||||
Install it as a dev dependency in your project and it will automatically add a script in your `package.json` to execute it.
|
||||
## Installation
|
||||
|
||||
Install it as a dev dependency in your project and it will check your configuration and add a script in your `package.json` to check the configuration again easily afterwards.
|
||||
|
||||
```shell
|
||||
npm install --save-dev @openstapps/configuration
|
||||
@@ -21,24 +23,6 @@ npm install -g @openstapps/configuration
|
||||
openstapps-configuration --help
|
||||
```
|
||||
|
||||
## Checked files
|
||||
## Configuration
|
||||
|
||||
If your project's root contains a `tsconfig.json` or a `tslint.json` they will be checked if they contain the extension of the default configurations.
|
||||
|
||||
## Copied files
|
||||
|
||||
The following files are automatically copied to your project's root directory if they do not exist yet. Use `-r, --replace` to replace existing files.
|
||||
|
||||
| File | Purpose |
|
||||
| --- | --- |
|
||||
| `.editorconfig` | Configuration for your editor/IDE about basic settings for indentation and formatting |
|
||||
| `.gitignore` | Configuration for Git about which files to ignore from versioning |
|
||||
| `.npmignore` | Configuration for NPM about which files to exclude from packaging |
|
||||
| `tsconfig.json` | Configuration for [TypeScript compiler](https://www.typescriptlang.org/docs/handbook/tsconfig-json.html) |
|
||||
| `tslint.json` | Configuration for [TSLint](https://palantir.github.io/tslint/usage/configuration/) |
|
||||
|
||||
## Adjusted files
|
||||
|
||||
Your project's `package.json` will be examined to determine whether or not you have `nyc` installed in your `devDependencies`. If it is installed the recommended configuration for `nyc` will be added to your `package.json` if it does not exist.
|
||||
|
||||
A script called `check-configuration` will be added to your `package.json` to execute the configuration script manually again.
|
||||
To configure how your project's configuration is checked add a property `"openstappsConfiguration"` to your `package.json` with all or some properties of the [configuration](https://openstapps.gitlab.io/configuration/interfaces/_src_common_.configuration.html);
|
||||
|
||||
Reference in New Issue
Block a user