https://github.com/giltayar/bilt

A build tool for NPM monorepos
https://github.com/giltayar/bilt

bilt build-tools monorepo npm

Last synced: 6 days ago
JSON representation

A build tool for NPM monorepos

• Host: GitHub
• URL: https://github.com/giltayar/bilt
• Owner: giltayar
• License: mpl-2.0
• Created: 2017-07-02T19:28:56.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2022-12-27T15:11:45.000Z (about 2 years ago)
• Last Synced: 2025-01-21T05:33:02.171Z (12 days ago)
• Topics: bilt, build-tools, monorepo, npm
• Language: JavaScript
• Homepage:
• Size: 6.68 MB
• Stars: 138
• Watchers: 4
• Forks: 23
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# Bilt

A build tool for NPM monorepos

## What is Bilt

Bilt is a CLI that builds, tests, and publishes NPM packages

in your monorepos, and does that in the proper order, according to the packages dependency graph,

while guaranteeing that only those packages that were not built (and their dependents) get built.

## Why Bilt

(To go directly to the meat of Bilt, read

[Structure of a Bilt monorepo](./docs/monorepo-structure.md) and then

go to the [Getting Started](./docs/getting-started.md) chapter.)

Monorepos are a wonderful concept! They enable us to structure our code as a large set of

loosely-coupled packages, instead of one big monolithic codebase, which is usually

tightly-coupled.

But the current build tools we have for monorepos are lacking. They are either difficult

to work with (Bazel), not powerful enough for big monorepos (Lerna), or can work only with

specific codebases (Nx). For more, see the [Alternatives](./docs/alternatives.md) section.

Bilt is designed for small and large repos, and is simple to use, assuming your

monorepo is built as a series of NPM packages linked together by an NPM dependency graph.

## Table of Contents

1. [Monolithic codebases vs monorepos](./docs/monolithic-vs-monorepos.md)

1. [Alternatives to Bilt](./docs/alternatives.md)

1. [Bilt concepts](./docs/concepts.md)

1. [Structure of a Bilt monorepo](./docs/monorepo-structure.md)

1. [Getting started](./docs/getting-started.md)

1. [How Bilt works](./docs/how-bilt-works.md)

1. [Reference](./docs/reference.md)

1. [Build configurations](./docs/build-configurations.md)

## Contributing

If you want to help contribute, to built, go [here](./docs/contributing.md) to learn about the Bilt code, how to build it, and how to contribute.