Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@rushstack/heft

Package Overview
Dependencies
Maintainers
3
Versions
358
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@rushstack/heft

The Rush Stack extensible build system

  • 0.3.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
24K
increased by30.92%
Maintainers
3
Weekly downloads
 
Created
Source

@rushstack/heft

🚨 This is an early preview release. Please report issues! 🚨

heft

Heft is an extensible build system designed for use with the Rush Stack family of tools. You don't need a monorepo to use Heft, however. It also works well for small standalone projects. Compared to other similar systems, Heft has some unique design goals:

  • Scalable: Heft interfaces with the Rush build orchestrator, which is optimized for large monorepos with many people and projects. Heft doesn't require Rush, though.

  • Familiar: Heft is an everyday Node.js application -- developers don't need to install native prerequisites such as Python, MSYS2, or the .NET Framework. Heft's source code is easy to understand and debug because it's 100% TypeScript, the same programming language as your web projects. Developing for native targets is also possible, of course.

  • Polished and complete: Philosophically, Rush Stack aspires to provide a comprehensive solution for typical TypeScript projects. Pluggable task abstractions often work against this goal: It's expensive to optimize and support (and document!) every possible cocktail of tech choices. The best optimizations and integrations need to leverage assumptions about implementation details. Heft is pluggable. But our aim is to agree on a recommended toolkit that works well for a broad range of scenarios, then work together on the deep investments that will make it a great experience.

  • Extensible: Most projects require at least a few specialized tasks such as preprocessors, postprocessors, or loaders. Heft allows you to write your own plugins using the tapable hook system (familiar from Webpack). Compared to loose architectures such as Grunt or Gulp, Heft ships a standard set of build stages for custom tasks to hook into. Working from a standardized starting point makes it easier to get technical support for custom rigs.

  • Optimized: Heft tracks fine-grained performance metrics at each step. Although Heft is still in its early stages, the TypeScript plugin already implements sophisticated optimizations such as: filesystem caching, incremental compilation, symlinking of cache files to reduce copy times, hosting the compiler in a separate worker process, and a unified compiler pass for Jest and Webpack.

  • Professional: The Rush Stack projects are developed by and for engineers who ship major commercial services. Each feature is designed, discussed in the open, and thoughtfully code reviewed. Despite being a free community collaboration, this software is developed with the mindset that we'll be depending on it for many years to come.

This is an early preview release, however the following tasks are already available:

  • Compiler: TypeScript with incremental compilation, with "watch" mode
  • Linter: TypeScript-ESLint, plus legacy support for projects that still use TSLint
  • Test runner: Jest
  • Bundler: Webpack, includingwebpack-dev-server with watch mode
  • .d.ts bundler: API Extractor
  • Asset management: Heft also includes a copy-static-assets helper supporting arbitrary globs, with "watch" mode

For more detailed documentation, please see the Heft topic on the Rush Stack website.

Keywords

FAQs

Package last updated on 24 Jul 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc