Nebulous Puffy Marshmallows


    0.1.3-2 • Public • Published


    A Stylus-powered frontend toolkit based on Bootstrap.

    Landscape is currently in early stages of development and breaking changes will most certainly be introduced. Recommended use for development purposes only.

    To get started -- checkout the docs!


    To install Landscape you must have nodejs installed.

    $ npm install -g landscape

    For automatic generation of linear gradient PNGs, install node-canvas (does not currently work on Windows):

    $ npm install -g canvas

    Note: You can install the packages locally by omitting the -g switch, but for ease of use it's recommended to install them globally.


    First you need access to Landscape within Stylus, this can be done with the Stylus executable or programatically.

    Stylus executable

    $ stylus --use landscape mytheme.styl

    For more info, see Stylus docs.


    var landscape = require('landscape');

    Customize the theme

    Make a copy of the bootstrap theme and then change the variables inside config.styl to suite your needs. To make your app use your theme, just point it to your theme.styl file and Stylus should do the rest.

    How to run the docs locally?

    You will have to clone the git repo, since the docs are not included in the npm package.

    $ git clone

    Also make sure you get the submodules.

    $ git submodule update --init

    Install all npm packages and then run app.js.

    cd docs
    $ docs/ npm update
    $ docs/ node app.js

    Note: If you're running Windows you will have to uncomment the canvas package in package.json.

    Coding convention

    Since Stylus is extremely lenient code-wise (you can omit braces, colons and semi-colos) we have put this tiny coding convention in place for Landscape:

    • All braces and semi-colons are omitted
    • Variables are prepended with ($) dollar-sign
    • Properties are appended with (:) colon


    $color = #aaa
        padding4px 10px

    Copyright and license

    Copyright 2012 ESN Social Software AB
    Copyright 2012 Twitter, Inc.

    Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

    Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.




    npm i landscape

    DownloadsWeekly Downloads






    Last publish


    • mekwall