Building from Source

Prerequisites

• Leiningen 2.x
• node.js and npm

OS Specific Prerequisites

OS X

None. Skip to Build.

Windows

Download Cygwin.

You may need to change \/etc\/fstab (path in Cygwin) to fix a directory permission error when building. Change this line:

none /cygdrive cygdrive binary,posix=0,user 0 0

Add ,noacl to the line:

none /cygdrive cygdrive binary,posix=0,user,noacl 0 0

Close and re-open Cygwin Terminal.

The issue:

• "mkdir: cannot create directory" error running branch build on Windows 7 · Issue #1918 · LightTable\/LightTable

Linux

To run electron on Linux you need to have libgconf-2.so.4 installed.

Ref: Linux (Arch) build depends on libgconf-2.so.4

Note that, on Debian-based distros, you may need to install an additional package as there is a pre-existing node package and the standard Node.js package on these distros installs a Node.js executable named nodejs instead of node as our build script expects. See issue #1931 for some background.

Build

To build LightTable from scratch on OSX, Windows Cygwin or Linux:

$ git clone https://github.com/LightTable/LightTable.git
$ cd LightTable
# Creates a directory in builds/
$ script/build.sh

This will take a few minutes the first time as electron and plugins are downloaded. Subsequent invocations are faster.To override the output directory, specify $VERSION e.g. VERSION=0.8.1-pre script/build.sh.

On subsequent builds, use script/build-app.sh for quicker builds that don't require updating plugins or electron.If any ClojureScript files change, you must run lein cljsbuild once app. On Windows, you may need to comment out the :source-mapline before compiling ClojureScript to get around issue 1025.

Usage

Once you've built LightTable, run it in one of the following ways:

• OS X

  • As a commandline executable: builds/lighttable-0.8.0-mac/light
  • As an application: open -a $PWD/builds/lighttable-0.8.0-mac/LightTable.app

• Linux

  • As a commandline executable: builds/lighttable-0.8.0-linux/light
  • As an application: builds/lighttable-0.8.0-linux/LightTable

• Windows

  • As an application: builds/lighttable-0.8.0-windows/LightTable.exe

You can also run LightTable with script/light.sh. This script allows you to skip running script/build-app.sh. While it's useful as a dev convenience, final changes should be QAed with a fresh build from script/build-app.sh.