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 --use landscape mytheme.styl
For more info, see Stylus docs.
var landscape = require('landscape'); ... stylus.use(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 email@example.com:esnme/landscape.git
Also make sure you get the submodules.
$ git submodule update --init
Install all npm packages and then run
$ cd docs $ docs/ npm update $ docs/ node app.js
Note: If you're running Windows you will have to uncomment the canvas package in
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 (
- Properties are appended with (
$color = #aaa .button color: $color padding: 4px 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.