Popularity
4.2
Declining
Activity
3.8
-
482
11
17

Monthly Downloads: 0
Programming language: JavaScript
License: MIT License
Tags: Build Tools     Runner     Tasks     Start    
Latest version: v0.6.0

start alternatives and similar modules

Based on the "Build Tools" category

Do you think we are missing an alternative of start or a related project?

Add another 'Build Tools' Module

README

start

:warning: Project has been transferred to NexTools metarepo

linux windows coverage

  • functional – in all senses
  • fast – parallelism and concurrency
  • shareable – presets as published packages
  • 4th line to align with logo on the right

TOC

Example

.
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ foo/
β”‚   β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”‚   └── index.ts
β”‚   β”‚   β”œβ”€β”€ test/
β”‚   β”‚   β”‚   └── index.ts
β”‚   β”‚   └── package.json
β”‚   └── bar/
β”‚       β”œβ”€β”€ src/
β”‚       β”‚   └── index.ts
β”‚       β”œβ”€β”€ test/
β”‚       β”‚   └── index.ts
β”‚       └── package.json
β”œβ”€β”€ package.json
└── tasks.ts
$ yarn add --dev --ignore-workspace-root-check \
  @babel/core \
  @babel/register \
  @babel/preset-env \
  @babel/preset-typescript \
  @start/cli \
  @start/reporter-verbose \
  @start/plugin-sequence \
  @start/plugin-parallel \
  @start/plugin-xargs \
  @start/plugin-find \
  @start/plugin-find-git-staged \
  @start/plugin-remove \
  @start/plugin-read \
  @start/plugin-rename \
  @start/plugin-write \
  @start/plugin-lib-babel \
  @start/plugin-lib-typescript-generate \
  @start/plugin-lib-eslint \
  @start/plugin-lib-istanbul \
  @start/plugin-lib-tape \
  @start/plugin-lib-codecov
// package.json

{
  "private": true,
  "description": "Start example",
  "workspaces": [
    "packages/*"
  ],
  "devDependencies": {},
  "start": {
    // tasks file, default to `./tasks`
    "file": "./tasks"
    "require": [
      [
        "@babel/register",
        {
          "extensions": [
            ".ts",
            ".js"
          ]
        }
      ]
    ],
    "reporter": "@start/reporter-verbose"
  },
  "babel": {
    "presets": [
      [
        "@babel/preset-env",
        {
          "targets": {
            "node": "current"
          }
        }
      ],
      // Babel 7
      "@babel/preset-typescript"
    ]
  }
}
// tasks.ts

// write tasks file once, publish it and then reuse or even extend
// in all projects using `start.preset` option in `package.json`,
// something like `my-start-preset` package with everything included

import sequence from '@start/plugin-sequence'
import parallel from '@start/plugin-parallel'
import xargs from '@start/plugin-xargs'
import find from '@start/plugin-find'
import findGitStaged from '@start/plugin-find-git-staged'
import remove from '@start/plugin-remove'
import read from '@start/plugin-read'
import rename from '@start/plugin-rename'
import write from '@start/plugin-write'
import babel from '@start/plugin-lib-babel'
import typescriptGenerate from '@start/plugin-lib-typescript-generate'
import eslint from '@start/plugin-lib-eslint'
import {
  istanbulInstrument,
  istanbulReport,
  istanbulThresholds
} from '@start/plugin-lib-istanbul'
import tape from '@start/plugin-lib-tape'
import codecov from '@start/plugin-lib-codecov'

const babelConfig = {
  babelrc: false,
  presets: [
    [
      '@babel/preset-env',
      {
        targets: {
          node: 6
        },
        modules: false
      }
    ],
    '@babel/preset-typescript'
  ]
}

// each named export is a "task"
export const build = (packageName: string) =>
  sequence(
    find(`packages/${packageName}/src/**/*.ts`),
    read,
    babel(babelConfig),
    rename((file) => file.replace(/\.ts$/, '.js')),
    write(`packages/${packageName}/build/`)
  )

export const dts = (packageName: string) =>
  sequence(
    find(`packages/${packageName}/src/index.ts`),
    typescriptGenerate(`packages/${packageName}/build/`)
  )

export const pack = (packageName: string) =>
  sequence(
    find(`packages/${packageName}/build/`),
    remove,
    // child-processes
    parallel(['build', 'dts'])(packageName)
  )

// child processes
export const packs = xargs('pack')

export const dev = (packageName: string) =>
  watch(`packages/${packageName}/**/*.ts`)(
    build(packageName)
  )

export const lint = () =>
  sequence(
    findGitStaged(['packages/*/{src,test}/**/*.ts']),
    read,
    eslint()
  )

export const lintAll = () =>
  sequence(
    find(['packages/*/{src,test}/**/*.ts']),
    read,
    eslint()
  )

export const test = () =>
  sequence(
    find('coverage/'),
    remove,
    find('packages/*/src/**/*.ts'),
    istanbulInstrument({ esModules: true, extensions: ['.ts'] }),
    find('packages/*/test/**/*.ts'),
    tape(),
    istanbulReport(['lcovonly', 'html', 'text-summary']),
    istanbulThresholds({ functions: 100 })
  )

export const ci = () =>
  sequence(
    // nested task
    lintAll(),
    // nested task
    test(),
    find('coverage/lcov.info'),
    read,
    codecov
  )
$ yarn start
# or
$ npx start

One of the following task names is required:
* build
* dts
* pack
* packs
* dev
* lint
* lintAll
* test
* ci
$ yarn start build foo
$ yarn start dts foo
$ yarn start pack foo
$ yarn start packs foo bar
$ yarn start dev bar
$ yarn start lint
$ yarn start lintAll
$ yarn start test
$ yarn start ci

How to

  • [Use CLI and pass in options](packages/cli)
  • [Create a plugin](packages/plugin)
  • [Create a reporter](packages/reporter-verbose)
  • Create a preset

Recipes

  • Node.js TypeScript library preset – @deepsweet/start-preset-node-ts-lib
  • Node.js TypeScript libraries monorepo – Start project builds itself from sources using sources, see [tasks/index.ts](tasks/index.ts)
  • React / React Native (higher-order) components monorepo – hocs
  • React app – to be added

Packages

Core

  • ⬛️ [cli](packages/cli) – CLI entry point
  • βš™οΈ [plugin](packages/plugin) – plugin creator
  • πŸ“ƒ [reporter-verbose](packages/reporter-verbose) – verbose reporter

Plugins

Misc

  • ⏩ [plugin-sequence](packages/plugin-sequence) – run plugins in sequence
  • πŸ”€ [plugin-parallel](packages/plugin-parallel) – run tasks as parallel child processes with same agruments
  • πŸ”‚ [plugin-xargs](packages/plugin-xargs) – run task as parallel child process for each argument
  • 🐣 [plugin-spawn](packages/plugin-spawn) – spawn new child process
  • πŸ‘” [plugin-env](packages/plugin-env) – set environment variable using process.env
  • πŸ”Œ [plugin-input-files](packages/plugin-input-files) – inject arguments as files into Start flow files
  • πŸ”Œ plugin-output-files – to be added

FS

  • πŸ” [plugin-find](packages/plugin-find) – find files using glob patterns
  • πŸ” [plugin-find-git-staged](packages/plugin-find-git-staged) – find Git staged files and filter them using glob patterns
  • πŸ“– [plugin-read](packages/plugin-read) – read files content
  • πŸ”  [plugin-rename](packages/plgun-rename) – rename files
  • ❌ [plugin-remove](packages/plugin-remove) – remove files or directories
  • πŸ‘― [plugin-copy](packages/plugin-copy) – copy files to relative destination using streams and keeping folders structure
  • ✏️ [plugin-write](packages/plugin-write) – write files with source maps to relative destination keeping folders structure
  • ✏️ [plugin-overwrite](packages/plugin-overwrite) – overwrite files
  • πŸ‘€ [plugin-watch](packages/plugin-watch) – watch for new or changed files matched by glob patterns
  • πŸ—œ [plugin-unpack](packages/plugin-unpack) – unpack .tar/.tar.bz2/.tar.gz/.zip archives

Build and bundle

  • 🏭 [plugin-lib-babel](packages/plugin-lib-babel) – transform files using Babel
  • 🏭 [plugin-lib-esm-loader](packages/plugin-lib-esm-loader) – copy a predefined ESM loader file to a directory
  • 🏭 [plugin-lib-webpack](packages/plugin-lib-webpack) – bundle files using Webpack
  • 🏭 [plugin-lib-webpack-dev-server](packages/plugin-lib-webpack-dev-server) – run Webpack development server
  • 🏭 [plugin-lib-rollup](packages/plugin-lib-rollup) – bundle files using Rollup
  • 🏭 [plugin-lib-typescript-generate](packages/plugin-lib-typescript-generate) – generate .d.ts files using TypeScript
  • 🏭 [plugin-lib-flow-generate](packages/plugin-lib-flow-generate) – generate .js.flow files using Flow
  • 🏭 [plugin-lib-postcss](packages/plugin-lib-postcss) – transform files using PostCSS
  • 🏭 plugin-lib-less – to be migrated
  • 🏭 plugin-lib-clean-css – to be migrated
  • 🏭 plugin-lib-uglify – to be migrated

Tests

  • βœ… [plugin-lib-jest](packages/plugin-lib-jest) – run tests using Jest
  • βœ… [plugin-lib-tape](packages/plugin-lib-tape) – run tests using Tape
  • βœ… [plugin-lib-karma](packages/plugin-lib-karma) – run tests using Karma
  • πŸ’― [plugin-lib-instanbul](packages/plugin-lib-istanbul) – collect, report and check code coverage using Istanbul
  • βœ… plugin-lib-ava – to be migrated
  • βœ… plugin-lib-mocha – to be migrated
  • ❓ [plugin-assert](packages/plugin-assert) – Node.js assert()

Lint, check and fix

  • 🚷 [plugin-lib-eslint](packages/plugin-lib-eslint) – lint and/or fix code using ESLint
  • 🚷 [plugin-lib-prettier-eslint](packages/plugin-lib-prettier-eslint) – fix code(style) using Prettier + ESLint
  • 🚷 [plugin-lib-typescript-check](packages/plugin-lib-typescript-check) – check types using TypeScript
  • 🚷 [plugin-lib-flow-check](packages/plugin-lib-flow-check) – check types using Flow

CI and publish

  • πŸ’― [plugin-lib-codecov](packages/plugin-lib-codecov) – send code coverage report to codecov.io
  • πŸ”’ [plugin-lib-npm-version](packages/plugin-lib-npm-version) – bump package version
  • πŸ“¦ [plugin-lib-npm-publish](packages/plugin-lib-npm-publish) – publish package to NPM
  • πŸ’― plugin-lib-coveralls – to be migrated

Tasks

Coming soon.

Roadmap

  • [x] stabilize and publish 0.1.0 of everything
  • [x] documentation
  • [ ] more tests
  • [ ] migrate the rest of important plugins

All the packages in this repository are released under the terms of the [MIT License](license.md).

The font used in logo is supernova fat.


*Note that all licence references and agreements mentioned in the start README section above are relevant to that project's source code only.