hhy5277 / lass

:girl: Lass scaffolds a modern package boilerplate for Node.js

Lass scaffolds a modern package boilerplate for Node.js

_{A lass that fell in love with a lad • Built by @niftylettuce and contributors}

---

❤️ Love this project? Support @niftylettuce's FOSS on Patreon or PayPal 🦄

Table of Contents

• Features
• Requirements
• Install
• Usage
  • Create a package
  • Test it
• Tips
  • Configuration
  • Version Bump and Release
• Related
• Contributors
• Trademark Notice
• License

Features

• Unit testing with ava
• Commit linting with commitlint
• Linting with eslint (with an option to choose between prettier and xo or standard)
• Markdown Linting with remark
• Automatic code formatting with prettier
• Automatic git init
• Automatic npm install (or yarn install if selected)
• Automatic builds, tests, and code coverage uploading to Codecov with Travis-CI
• Includes git/editor configurations:
  • .gitignore
  • .gitattributes
  • .editorconfig
• Automatic markdown formatting and linting with remark
  • Adheres to GitHub flavored markdown standards
  • Adds contributors section automatically with remark-contributors
  • Adjusts heading gaps automatically
  • Adds a license block automatically with remark-license
  • Utilizes configurable presets with remark-preset-github
• Highly configurable and remembers your defaults with sao
• Test coverage with nyc
• Automatically generated files with tailored defaults
  • Readme with badges through Shields.io
  • Choose from (343) different licenses with spdx-license-list (defaults to your npm default or MIT)
  • Automatically inserts license year/name/email/website for MIT license if selected

Requirements

Node.js v7.6.0+

Install

npm:

npm install -g lass

yarn:

yarn global add lass

Usage

Create a package

lass new-package
cd new-package

Test it

npm:

npm test

yarn:

yarn test

Tips

Configuration

You should configure npm init defaults before using this package.

Run the following commands and replace the values below with your own:

npm config set init-author-email "[email protected]"
npm config set init-author-name "Nick Baugh"
npm config set init-author-url "http://niftylettuce.com"
npm config set init-license "MIT"
npm config set init-version "0.0.0"

These defaults get utilized by lass when scaffolding a package and npm init in general.

To check your existing configuration, run npm config list -l.

Version Bump and Release

We highly recommend to use the tools np and release to version bump and release your package to GitHub and NPM.

Related

• lad - Scaffold a Koa webapp and API framework for Node.js
• lipo - Free image manipulation API service built on top of Sharp
• cabin - Logging and analytics solution for Node.js, Lad, Koa, and Express

Contributors

Name	Website
Nick Baugh	http://niftylettuce.com
Pablo Varela	http://pablo.life
Shaun Warman	http://shaunwarman.com

Trademark Notice

Lass, Lad, Cabin, Lipo, and their respective logos are trademarks of Niftylettuce LLC. These trademarks may not be reproduced, distributed, transmitted, or otherwise used, except with the prior written permission of Niftylettuce LLC. If you are seeking permission to use these trademarks, then please contact us.

License

MIT © Nick Baugh