adonisjs
AdonisJS preset for mrm to keep the project configuration files in-sync and consistent across various projects.
Table of contents
What is MRM?
You might be curious to know what the heck is MRM?
MRM is a command line tool to scaffold new projects. But instead of just creating the initial set of files, it has powerful utilities to update them as well.
For better explanation, I recommend reading this article by the project author.
What is MRM Preset?
This module is a custom preset of tasks for MRM and is used by AdonisJS and many other projects I author.
You can also create a preset for your own needs. However, just go through the tasks once to see if they fit your needs and that way you can avoid creating your own tasks.
Getting started
Let's quickly learn how to use this preset, before we dig into the specifics of tasks.
npm i --save-dev mrm @adonisjs/mrm-presetAdd script to package.json file
{
"scripts": {
"mrm": "mrm --preset=@adonisjs/mrm-preset"
}
}and then run it as follows
## Initiate by creating config file
npm run mrm init## Execute all tasks (for new projects)
npm run mrm allTasks
Let's focus on all the tasks supported by AdonisJS preset.
Appveyor
Appveyor tasks creates a configuration file (appveyor.yml) in the root of your project. The tasks depends on the config file config.json and requires following key/value pairs.
{
"services": ["appveyor"],
"minNodeVersion": "12.0.0"
}To remove support for appveyor from your project, just npm run mrm appveyor task by removing the appveyor keyword from the services array.
{
"services": []
}npm run mrm appveyorCircle CI
Circle CI tasks creates a configuration file (.circleci/config.yml) in the root of your project. The tasks depends on the config file config.json and requires following key/value pairs.
{
"services": ["circleci"],
"minNodeVersion": "12.0.0"
}To remove support for circleci from your project, just npm run mrm circleci task by removing the circleci keyword from the services array.
{
"services": []
}npm run mrm circleciContributing.md template
Creates .github/CONTRIBUTING.md file. This file is shown by Github to users creating new issues.
The content of the template is pre-defined and is not customizable. If you want custom template, then it's better to create the file by hand.
Template for Typescript The typescript template is used when
ts=trueinside the config file.{ "ts": true }Otherwise the default template will be used.
Editorconfig file
Creates a
.editorconfigfile inside the project root. The editor config file is a way to keep the editor settings consistent regardless of the the editor you open the files in.
You may need a plugin for your editor to make editorconfig work.
The file is generated with settings defined inside the task file and again is not customizable.
Eslint
Installs eslint and eslint-plugin-adonis. Also it will remove tslint and it's related dependencies from the project.
Github templates
Creates issues and PR template for Github. The contents of these templates will be pre-filled anytime someone wants to create a new issue or PR.
Github Actions
Github actions tasks creates a configuration file (.github/workflows/test.yml) in the root of your project. The tasks depends on the config file config.json and requires following key/value pairs.
{
"services": ["github-actions"],
"minNodeVersion": "14.15.4"
}To remove support for github-actions from your project, just npm run mrm github-actions task by removing the github-actions keyword from the services array.
{
"services": []
}npm run mrm github-actionsGitignore template
Creates .gitignore file in the root of your project. Following files and folders are ignored by default. However, you can add more to the template.
node_modules
coverage
test/__app
.DS_STORE
.nyc_output
.idea
.vscode/
*.sublime-project
*.sublime-workspace
*.log
build
docs
dist
shrinkwrap.yamlLicense template
Creates LICENSE.md file in the root of your project.
You can choose from one of the available licenses when running npm run init command or define it by hand inside config.json file.
{
"license": "MIT"
}If not defined, will fallback to package.json file or MIT.
Np release management
np is a sick (👌) tool to publish your npm packages by ensuring that your package is in healthy state for release.
We recommend reading their README too https://github.com/sindresorhus/np.
Package file generation
This tasks does lots of work to install handful of packages and update package.json file.
The list of operations is based on my personal learnings while maintaining open source projects.
Testing
The japa test runner is installed along side with japaFile.js.
Typescript setup
We create a tsconfig.json file and install following dependencies.
@types/nodetypescript@adonisjs/require-ts
Scripts
The following scripts are defined inside the package.json file.
cleanto clean the build folder before starting the build. We also installdel-clinpm package for this script to workcompileto compile the TypeScript code to JavaScriptbuildruns compileprePublishOnlyto compile before publishing to npm.
Prettier
Installs prettier and eslint-plugin-prettier and eslint-config-prettier to setup prettier along side with eslint. Also the task will check, if .eslintrc.json file exists and then only performs the eslint specific setup
Probot applications
Configures certain probot application templates inside the .github directory. Currently, following apps are supported.
Readme file
Generates a Readme file using a pre-defined template. Feel free to change the contents of the file, since it's just a starting point.
Readme file TOC
Generates table of contents for the readme file. This tasks registers a git hook to automatically generate the TOC before every commit.
Under the hood npm package doctoc is used for generating the TOC, so make sure to read their readme file as well.
Validate commit
Configures a git hook to validate the commit messages. This is great, if you want to ensure that contributors to your project must form commit messages as per a given standard.
The default standard used is conventional-changelog and rules are defined inside this template, which is copied over to your project .github folder for readers reference.