The LoopBack documentation includes a number of README files from related repositories, including examples, data source connectors, and components.
Page Contents

LoopBack comprises dozens of GitHub repositories. Beyond the core repositories such as loopback, loopback-datasource-juggler, and loopback-boot, there are dozens of ancillary modules, that fall into three main categories:

  • Connectors: loopback-connector-rest, loopback-connector-mongodb, loopback-connector-soap, dozens of others; see LoopBack data source connectors.
  • Examples: loopback-getting-started, many others; see Tutorials and examples.
  • Components: loopback-component-oauth2, loopback-component-storage, loopback-component-passport, and so on.
    NOTE: These READMEs are currently not being reused; rather the content is largely duplicated in the doc pages. Ultimately, though, these should be single-sourced, as priorities permit.

Each of these repositories has its own documentation in the repository README file. It makes sense to maintain the documentation there, close to the code, where it can be updated as part of related pull requests to that module. At the same time, it’s useful to aggregate all the documentation on this site. So, essentially we want to keep the module-specific documentation in the README as well as in this repo (

Instead of manually copying the README files from their “home” repositories, we use Bash scripts to automate the process. This enables each repository to maintain its own README and yet also provide the same information in the documentation, with a single source to avoid divergence or duplication of effort.

There are two Bash scripts:

We have a Jenkins pipeline that runs the scripts whenever there is a commit to the repository.

As for READMEs from loopback-next, they are always fetched together with other doc files. To add a new README to the docs, just create a new page with README layout in the loopback-next repository. For an example of the README layout, see here.