Not a Package Manager


    2.4.2 • Public • Published


    Image of Lingon berries

    Build Status Dependency Status

    Lingon is a performant single-page application dev tool that focuses on developer happiness.
    At Spotify we use Lingon to build Angular.js applications.


    Lingon is a build tool that favors convention over configuration. By employing a similar file structure across your projects you can minimize the amount of build configuration you need to write and maintain. We've borrowed this idea from middleman and Sprockets. If you already know these tools you'll feel right at home with Lingon.

    Lingon allows you to enjoy the productive workflows from Middleman while leveraging an existing community of great gulp.js plugins.


    • A convention layer on top of node.js streams, compatible with Gulp.js.
    • Sprockets-like "include" directive for file concatenation
    • Uses Gulp plugins as Sprockets-like file processors
    • Built in development server.
    • Out-of-the box support for Less, EJS & Markdown

    Get started

    1. Install lingon CLI globally

    $ npm install -g lingon-cli

    2. Create a new project

    Create a minimal lingon project using the CLI:

    $ lingon new hello-world

    3. Run Lingon server

    cd hello-world
    $ lingon
    [ Lingon ] Working directory: /path/to/hello-world
    [ Lingon ] http server listening on: http://localhost:5678/

    Project structure

    Your project looks like this:

    $ ls

    Lingon is configured and run from a file called lingon.js. This is where you define which plugins to use and how they should interact. The most basic valid "lingon.js" file looks like this:

    #!/usr/bin/env node
    var lingon = require("lingon");

    This will allow Lingon to build and serve a basic web applications. By default, Lingon will look for source files in ./source and put build files in ./build. These defaults can be changed like this:

    #!/usr/bin/env node
    var lingon = require("lingon");
    lingon.config.sourcePath = "/some/other/path";
    lingon.config.buildPath = "/dev/null";

    Check out the usage documentation for a walkthrough of all features.

    Lingon tasks

    # Generate a lingon new lingon project: 
    lingon new my-project # will clone 
    lingon new my-project -t angular # will clone 
    # Start the server: 
    # Build once and quit: 
    lingon build
    # Show version: 
    lingon -v
    # Show help: 
    lingon -h
    # Start the server on a custom port: 
    lingon server -p 1111

    Alternatively, you can execute the lingon.js file directly without installing lingon-cli.
    This is useful when building in Jenkins and similar.


    Usage examples

    Project templates

    Angular.js application


    How does it relate to Make, Gulp, Grunt, X?

    Lingon favors convention over configuration. For example, Grunt & Gulp provide powerful API's for building very customized build scripts. This requires you to write a bit of code everytime you want your build system to do something new. Each step in the build pipeline is carefully orchestrated so every project becomes special. This means there's a lot of copy-pasta going on when starting something new.

    Lingon is inspired by Sprockets and uses a convention approach: A set of simple rules are used to determine what files to build, how to build them and where to put them. Files are processed based on their filename extensions.

    Example: "index.html.ejs" will be run through the EJS processor. These processors are gulp plugins, which allows us to leverage a large collection of great existing plugins. If you want to teach Lingon something new, you just have to define the mapping between a file ending and a gulp plugin. That's it!

    Test it

    Run the bats e2e tests:

    $ ./


    We'd love some help!
    Take a look at our file for guidelines.


    Licensed under the Apache license.

    Lingon photo by thriol


    npm i lingon

    DownloadsWeekly Downloads






    Last publish


    • spotify-eng
    • koggdal
    • pmarbach-spotify
    • jpettersson
    • philipvonbargen
    • spotifybot