Not a Package Manager

    lingon

    2.4.2 • Public • Published

    lingon

    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.

    Overview

    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.

    Features

    • 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
     
    node_modules/
    source/
    .gitignore
    package.json
    bower.json
    lingon.js
    README.md
    LICENSE

    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 https://github.com/javoire/lingon-template-minimal 
    lingon new my-project -t angular # will clone https://github.com/jpettersson/lingon-ng-template 
     
    # Start the server: 
    lingon
     
    # 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.

    Documentation

    Usage examples

    Project templates

    Angular.js application

    Minimal

    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:

    $ ./tests.sh
    

    Contributions

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

    License

    Licensed under the Apache license.

    Lingon photo by thriol

    Install

    npm i lingon

    DownloadsWeekly Downloads

    44

    Version

    2.4.2

    License

    Apache-2.0

    Last publish

    Collaborators

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