npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

lingon

v2.4.2

Published

A minimal static site generator inspired by Middleman and Sprockets, compatible with gulp plugins.

Downloads

588

Readme

lingon

![Image of Lingon berries] (https://farm3.staticflickr.com/2548/3873990304_1d2bd40ebc_m.jpg)

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