1.0.11 • Public • Published

    Build Status Codacy Badge Codacy Badge npm version


    "Relative Require": A nodejs module for requiring files in paths relative to one where a specific package.json is located.

    Why is this needed?

    Because NodeJS does not have a robust way of determining the root path of a running application. Sure, when your app is a couple of files you dont have problems, but as it starts growing, with modular parts and plugins, you want to be sure you can locate the actual root of your application. Also, mocha makes your __basedir stop working.


    How to use?

    npm install rlequire --save
    const rlequire = require("rlequire")
    const Client = rlequire("your-app", "./src/model/client.js", [optional, boolean] forceRecheck).Client;

    rrequire will search the current folder of the file from which it is invoked and the entire upstream directory until the root of the filesystem. Whenever a package.json file is detected, it will attempt to parse it.

    • If the name field in the package.json matches your-app, it will detect that folder as the root of the app.
    • If the file path "./src/model/client.js" exists, relatively to the detected root folder, it will require the file for you.
    • The expensive directory traversal operation is done only the first time we need to determine the root of an app, unless the forceRescan optional argument is specified as true.


    npm i rlequire

    DownloadsWeekly Downloads






    Unpacked Size

    14.1 kB

    Total Files


    Last publish


    • silvae86