@skypilot/toolchain
Toolchain for Node projects
Last updated 19 days ago by williamthorsen .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @skypilot/toolchain 
SYNC missed versions from official npm registry.

@skypilot/toolchain

npm stable stable build npm next next build Codacy grade downloads license: ISC

An opinionated toolchain for developing Node packages.

Toolchain comes configured with:

  • Babel
  • ESLint
  • Jest
  • TypeScript
  • Lint-Staged (using Husky)
  • GitHub Actions versioning & publication workflows

with a pre-commit hook to enforce linting on commit.

What does it do

Toolchain installs all dependencies & configurations needed to start creating Node projects using TypeScript. Compilation, typing, linting, release versioning, and publication are pre-configured.

How to install

$ yarn add --dev @skypilot/toolchain
$ yarn toolchain init

The toolchain init command creates a set of configuration files that include scripts & configs for distributing the project as a package. A planned change is to have toolchain init create only the core files & configs. A separate command would add the files & configs for creating a package.

If Husky's post-install script isn't run automatically, use the command yarn toolchain install-husky to run the script.

How to use

Once Toolchain is installed and initialized:

  • The linter will run automatically on each commit Note: Branches beginning with wip- or ending with -wip will not be linted

  • ESLint, Jest, and TypeScript will automatically use the configurations created by Toolchain

GitHub Actions workflows will

  • run code-quality checks on every push to GitHub (except wip- and -wip branches)
  • publish an NPM package on every push to GitHub on the stable or prerelease branches

How to publish releases

Toolchain creates GitHub Actions workflows that automate the process of creating and releasing NPM packages. Two different types of automated releases are supported:

  • Stable release: Has an ordinary semver version number, such as 1.1.2
  • Prerelease: Has a version number with a version-tag suffix and iteration number, such as 1.0.0-beta.0

The workflows are configured to automatically

  • publish a stable release on every push to master
  • publish a prerelease on every push to alpha, beta, or next branch

Toolchain performs the following steps when a release is created. If any step fails, the release is halted.

  • Run all automated checks (typechecking, linting, and testing)
  • Build the package and generate types
  • Determine the next version number (based on commit messages)
  • Create a version tag
  • Publish the package to NPM (if publication is enabled)

For stable releases, the workflow will also:

  • Bump the version number in package.json
  • Generate an updated CHANGELOG.md
  • Commit these changes to the stable branch

Convenience scripts

These convenience scripts are added to package.json by yarn toolchain init:

  • all-ci-checks: Locally run the status checks that are run by the continuous-integration workflow
  • all-cq-checks: Run code-quality checks: linting, type-checking, and standalone tests
  • build: Build the project for distribution as an NPM package
  • ci: An alias for all-ci-checks
  • cq: An alias for all-cq-checks
  • generate-typings: Generate typings for the distribution
  • lint: Run the linter
  • prepublishOnly: Run all checks and build steps in preparation for publication to NPM
  • tc: An alias for typecheck
  • test: An alias for test:standalone
  • test:all: Run all tests using Jest
  • test:integration: Run all integration tests (tests that rely on external services) using Jest
  • test:standalone: Run all standalone tests (app, component, and unit tests, which do not rely
  • typecheck: Checks that all types in the project are valid

To run a script, use yarn run SCRIPT_NAME.

Current Tags

  • 4.0.5-alpha.1                                ...           alpha (a month ago)
  • 3.5.0-beta.0                                ...           beta (5 months ago)
  • 4.0.6                                ...           latest (19 days ago)
  • 4.0.7-next.0                                ...           next (15 days ago)

209 Versions

  • 4.0.7-next.0                                ...           15 days ago
  • 4.0.6                                ...           19 days ago
  • 4.0.6-next.0                                ...           21 days ago
  • 4.0.5                                ...           a month ago
  • 4.0.5-next.1                                ...           a month ago
  • 4.0.5-alpha.1                                ...           a month ago
  • 4.0.5-alpha.0                                ...           a month ago
  • 4.0.5-next.0                                ...           a month ago
  • 4.0.4                                ...           2 months ago
  • 4.0.4-next.1                                ...           2 months ago
  • 4.0.4-next.0                                ...           2 months ago
  • 4.0.3                                ...           2 months ago
  • 4.0.3-next.0                                ...           2 months ago
  • 4.0.2                                ...           2 months ago
  • 4.0.2-next.0                                ...           2 months ago
  • 4.0.1                                ...           2 months ago
  • 4.0.1-next.0                                ...           2 months ago
  • 4.0.0                                ...           2 months ago
  • 4.0.0-next.0                                ...           2 months ago
  • 3.6.4                                ...           2 months ago
  • 3.6.4-next.0                                ...           2 months ago
  • 3.6.3                                ...           2 months ago
  • 3.6.3-next.0                                ...           2 months ago
  • 3.6.2                                ...           2 months ago
  • 3.6.2-next.0                                ...           2 months ago
  • 3.6.1                                ...           3 months ago
  • 3.6.1-next.0                                ...           3 months ago
  • 3.6.0                                ...           3 months ago
  • 3.6.0-next.0                                ...           3 months ago
  • 3.5.14                                ...           3 months ago
  • 3.5.14-next.0                                ...           3 months ago
  • 3.5.13                                ...           3 months ago
  • 3.5.13-next.1                                ...           3 months ago
  • 3.5.12                                ...           3 months ago
  • 3.5.12-next.1                                ...           3 months ago
  • 3.5.12-next.0                                ...           3 months ago
  • 3.5.11                                ...           4 months ago
  • 3.5.11-next.0                                ...           4 months ago
  • 3.5.10                                ...           4 months ago
  • 3.5.10-next.0                                ...           4 months ago
  • 3.5.9                                ...           4 months ago
  • 3.5.9-next.2                                ...           4 months ago
  • 3.5.9-next.1                                ...           4 months ago
  • 3.5.8-next.1                                ...           4 months ago
  • 3.5.9-next.0                                ...           4 months ago
  • 3.5.8                                ...           4 months ago
  • 3.5.7                                ...           4 months ago
  • 3.5.6-next.1                                ...           4 months ago
  • 3.5.5                                ...           4 months ago
  • 3.5.5-next.0                                ...           4 months ago
  • 3.5.4                                ...           4 months ago
  • 3.5.4-next.1                                ...           4 months ago
  • 3.5.3                                ...           4 months ago
  • 3.5.3-next.0                                ...           4 months ago
  • 3.5.2                                ...           4 months ago
  • 3.5.2-next.0                                ...           4 months ago
  • 3.5.1                                ...           4 months ago
  • 3.5.1-next.0                                ...           4 months ago
  • 3.5.0                                ...           5 months ago
  • 3.5.0-next.0                                ...           5 months ago
  • 3.5.0-beta.0                                ...           5 months ago
  • 3.4.1-next.0                                ...           5 months ago
  • 3.4.1-beta.1                                ...           5 months ago
  • 3.4.1-alpha.1                                ...           5 months ago
  • 3.4.1-alpha.0                                ...           5 months ago
  • 3.4.1-beta.0                                ...           5 months ago
  • 3.5.0-alpha.7                                ...           5 months ago
  • 3.5.0-alpha.6                                ...           5 months ago
  • 3.5.0-alpha.5                                ...           5 months ago
  • 3.5.0-alpha.4                                ...           5 months ago
  • 3.5.0-alpha.3                                ...           5 months ago
  • 3.5.0-alpha.2                                ...           5 months ago
  • 3.5.0-alpha.1                                ...           5 months ago
  • 3.5.0-alpha.0                                ...           5 months ago
  • 3.4.0                                ...           5 months ago
  • 3.4.0-next.1                                ...           5 months ago
  • 3.4.0-next.0                                ...           5 months ago
  • 3.3.9-next.2                                ...           5 months ago
  • 3.3.10-beta.1                                ...           5 months ago
  • 3.3.10-next.0                                ...           5 months ago
  • 3.3.10-beta.0                                ...           5 months ago
  • 3.3.9                                ...           5 months ago
  • 3.3.9-next.1                                ...           5 months ago
  • 3.3.9-next.0                                ...           5 months ago
  • 3.3.8-next.0                                ...           5 months ago
  • 3.3.8                                ...           5 months ago
  • 3.3.6-next.0                                ...           5 months ago
  • 3.3.6                                ...           5 months ago
  • 3.3.5                                ...           5 months ago
  • 3.3.5-next.0                                ...           5 months ago
  • 3.3.4                                ...           5 months ago
  • 3.3.4-next.1                                ...           5 months ago
  • 3.3.4-beta.1                                ...           5 months ago
  • 3.3.4-next.0                                ...           5 months ago
  • 3.3.4-beta.0                                ...           5 months ago
  • 3.3.3                                ...           5 months ago
  • 3.3.3-next.0                                ...           5 months ago
  • 3.3.2                                ...           5 months ago
  • 3.3.2-next.0                                ...           5 months ago
  • 3.3.1                                ...           5 months ago
  • 3.3.1-next.0                                ...           5 months ago
  • 3.3.0                                ...           5 months ago
  • 3.3.0-next.0                                ...           5 months ago
  • 3.3.0-beta.0                                ...           5 months ago
  • 3.2.1                                ...           5 months ago
  • 3.2.1-next.0                                ...           5 months ago
  • 3.2.0                                ...           5 months ago
  • 3.1.0-next.2                                ...           5 months ago
  • 3.1.0                                ...           5 months ago
  • 3.1.0-next.1                                ...           5 months ago
  • 3.1.0-next.0                                ...           5 months ago
  • 3.1.0-alpha.2                                ...           5 months ago
  • 3.1.0-alpha.1                                ...           5 months ago
  • 3.0.1                                ...           5 months ago
  • 3.0.0-next.1                                ...           5 months ago
  • 3.0.0-next.0                                ...           5 months ago
  • 3.0.0                                ...           5 months ago
  • 2.1.10                                ...           5 months ago
  • 3.0.0-beta.1                                ...           5 months ago
  • 3.0.0-beta.0                                ...           5 months ago
  • 2.1.8                                ...           5 months ago
  • 2.1.7-next.0                                ...           5 months ago
  • 2.1.7                                ...           5 months ago
  • 2.1.5-next.1                                ...           5 months ago
  • 2.1.6                                ...           5 months ago
  • 2.2.0-beta.0                                ...           5 months ago
  • 2.1.6-beta.0                                ...           5 months ago
  • 2.1.5                                ...           5 months ago
  • 2.1.5-next.0                                ...           5 months ago
  • 2.1.4-next.0                                ...           5 months ago
  • 2.1.4                                ...           5 months ago
  • 2.1.3-next.0                                ...           5 months ago
  • 2.1.3                                ...           5 months ago
  • 2.1.2                                ...           5 months ago
  • 2.1.1-next.0                                ...           5 months ago
  • 2.1.1                                ...           5 months ago
  • 2.0.4-next.0                                ...           5 months ago
  • 2.0.4                                ...           5 months ago
  • 2.0.3                                ...           5 months ago
  • 2.1.0-next.2                                ...           5 months ago
  • 2.1.0-next.1                                ...           5 months ago
  • 2.1.0-next.0                                ...           5 months ago
  • 2.0.2                                ...           5 months ago
  • 2.0.1-next.0                                ...           5 months ago
  • 2.0.1                                ...           5 months ago
  • 2.0.0-next.1                                ...           5 months ago
  • 2.0.0                                ...           5 months ago
  • 1.14.8                                ...           5 months ago
  • 2.0.0-next.0                                ...           5 months ago
  • 1.15.0-next.1                                ...           5 months ago
  • 1.14.7                                ...           5 months ago
  • 1.14.6-next.2                                ...           5 months ago
  • 1.14.6-next.1                                ...           5 months ago
  • 1.14.6                                ...           5 months ago
  • 1.14.6-next.0                                ...           5 months ago
  • 1.14.5                                ...           5 months ago
  • 1.15.0-next.0                                ...           5 months ago
  • 1.14.0                                ...           5 months ago
  • 1.13.0                                ...           5 months ago
  • 1.12.1                                ...           5 months ago
  • 1.12.0                                ...           5 months ago
  • 1.12.0-next.0                                ...           5 months ago
  • 1.11.1-next.0                                ...           5 months ago
  • 1.11.0                                ...           5 months ago
  • 1.11.0-next.1                                ...           5 months ago
  • 1.11.0-next.0                                ...           5 months ago
  • 1.11.0-alpha.4                                ...           5 months ago
  • 1.11.0-alpha.3                                ...           5 months ago
  • 1.10.1-alpha.0                                ...           5 months ago
  • 1.11.0-alpha.1                                ...           5 months ago
  • 1.11.0-alpha.0                                ...           5 months ago
  • 1.9.1-next.2                                ...           5 months ago
  • 1.9.1-next.1                                ...           5 months ago
  • 1.9.1-next                                ...           5 months ago
  • 1.9.0-next                                ...           5 months ago
  • 1.8.11-next                                ...           5 months ago
  • 1.8.10-beta                                ...           5 months ago
  • 1.8.9-beta                                ...           5 months ago
  • 1.6.0-beta                                ...           5 months ago
  • 1.5.1                                ...           6 months ago
  • 1.5.0                                ...           6 months ago
  • 1.4.5                                ...           6 months ago
  • 1.4.4                                ...           6 months ago
  • 1.4.3                                ...           6 months ago
  • 1.4.1                                ...           6 months ago
  • 1.4.0-beta                                ...           7 months ago
  • 1.3.0                                ...           7 months ago
  • 1.2.0                                ...           7 months ago
  • 1.2.0-alpha                                ...           7 months ago
  • 1.1.5                                ...           7 months ago
  • 1.1.4                                ...           7 months ago
  • 1.1.3                                ...           7 months ago
  • 1.1.2                                ...           7 months ago
  • 1.1.1                                ...           7 months ago
  • 1.1.0                                ...           7 months ago
  • 1.0.1                                ...           7 months ago
  • 1.0.0                                ...           8 months ago
  • 0.4.21                                ...           8 months ago
  • 0.4.20                                ...           8 months ago
  • 0.4.19                                ...           8 months ago
  • 0.4.18                                ...           8 months ago
  • 0.4.17-alpha                                ...           8 months ago
  • 0.4.16-alpha                                ...           8 months ago
  • 0.4.15-alpha                                ...           8 months ago
  • 0.4.14-alpha                                ...           8 months ago
  • 0.4.12-alpha                                ...           8 months ago
  • 0.4.11-alpha                                ...           8 months ago
  • 0.3.7                                ...           10 months ago
  • 0.3.6                                ...           10 months ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 68
Dev Dependencies (3)

Copyright 2014 - 2016 © taobao.org |