Leksah, an Integrated Development Environment for Haskell

Leksah aims to integrate various Haskell development tools to provide a practical and pleasant development environment. The user interface is a mix of GTK+ and WebKit based components.

Documentation can be found on leksah.org.

Getting Leksah

Nix

Using Nix is the easiest way to get Leksah. It works well on Linux and MacOS. Please let us know it it works on the Windows Subsystem for Linux (WSL).

git clone --recursive https://github.com/leksah/leksah.git
cd leksah
nix-env -f . -i

If your project has a default.nix file along side it (in the same directory as your cabal.project file), leksah will use nix-shell -A shells.ghc --run commands that need ghc and ghci. It will use nix-shell -A shells.ghcjs --run for commands that need ghcjs.

A great way to set up a suitable default.nix for your project is described in project-development.md. This works even if you are not planning on using reflex.

If you want to make changes to Leksah run the ./leksah-nix.sh script to start Leksah itself in a nix-shell with everything needed to work on Leksah. Then open the Leksah cabal.project file.

On macOS the Leksah window start below other active application windows you can use Command+Shift+Tab to bring it to the top (issue 461).

Installation (without Nix)

Leksah requires ghc --version >=8.0.2 and cabal --version >=1.24. To get them go to haskell.og/download and choose the Minimal GHC or Haskell Platform.

• Windows latest github version built with AppVeyor
• OS X: official binaries
• Linux: build from source

Building from source (without Nix)

Step 1: Install C libraries

Fedora

sudo dnf install gobject-introspection-devel webkitgtk4-devel gtksourceview3-devel

Ubuntu/Debian

sudo apt-get install libgirepository1.0-dev libwebkit2gtk-4.0-dev libgtksourceview-3.0-dev

Arch Linux

sudo pacman -S gobject-introspection gobject-introspection-runtime gtksourceview3 webkit2gtk

macOS with MacPorts

sudo port install gobject-introspection webkit2-gtk gtksourceview3 gtk-osx-application-gtk3 adwaita-icon-theme`

You will also need to build a MacPorts compatible of GHC. First install GHC some other way then unpack the source for the GHC version you want to use and run:

sudo port install libxslt gmp ncurses libiconv llvm-3.5 libffi
./configure --prefix=$HOME/ghc-8.0.1 --with-iconv-includes=/opt/local/include --with-iconv-libraries=/opt/local/lib --with-gmp-includes=/opt/local/include --with-gmp-libraries=/opt/local/lib --with-system-libffi --with-ffi-includes=/opt/local/lib/libffi-3.2.1/include --with-ffi-libraries=/opt/local/lib --with-nm=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/nm-classic
make
make install
echo 'PATH: '"$PATH"

Make sure the $HOME/ghc-8.0.1/bin is present in PATH.

macOS with Homebrew

It might be possible to build Leksah using Homebrew now we have switched to WebKit 2. If you can figure it out please send us the details or better yet a pull request to update this file. Raise an issue if you try and it does not work.

Windows MSYS2

Install:

• MSYS2
• Chocolatey

Then in Bash shell with administrator privileges execute:

choco install ghc
pacman -S mingw64/mingw-w64-x86_64-pkg-config mingw64/mingw-w64-x86_64-gobject-introspection mingw64/mingw-w64-x86_64-gtksourceview3 mingw64/mingw-w64-x86_64-webkitgtk3

Set the following environment variables:

SET PATH=%APPDATA%\cabal\bin;C:\msys64\mingw64\bin;C:\msys64\usr\bin;C:\ProgramData\chocolatey\lib\ghc\tools\ghc-8.0.2\bin;C:\ProgramData\chocolatey\lib\cabal\tools;%PATH%
SET PKG_CONFIG_PATH=C:\msys64\mingw64\lib\pkgconfig
SET XDG_DATA_DIRS=C:\msys64\mingw64\share

(change C:\ProgramData\chocolatey\lib\ghc\tools\ghc-8.0.2\bin if a newer version is installed)

FreeBSD

pkg install devel/gobject-introspection x11-toolkits/gtksourceview3 www/webkit2-gtk3

Step 2: Clone repository and its submodules

git clone --recursive https://github.com/leksah/leksah.git
cd leksah

Step 3.a: Build - cabal new-build variant

Step 3.a.1: Install extra tools

cabal update
cabal install alex happy
cabal install haskell-gi

Make sure ~/.cabal/bin is present in the PATH (Windows: Make sure %APPDATA%\cabal\bin is present in the PATH).

Step 3.a.2: Build and run Leksah

macOS using MacPorts

XDG_DATA_DIRS=/opt/local/share ./leksah.sh

Other OS

./leksah.sh

Step 3.b: Build - stack variant

Step 3.b.1: Install extra tools

stack setup --upgrade-cabal
stack install alex happy
stack install haskell-gi
stack install gtk2hs-buildtools

Leksah needs cabal for the metadate feature to work correctly (even when using stack):

stack install cabal-install
cabal update

Step 3.b.2: Build and run Leksah

macOS using MacPorts

XDG_DATA_DIRS=/opt/local/share stack install
stack exec --no-ghc-package-path leksah

Other OS with Gtk+ 3.20 (or newer)

stack install
stack exec --no-ghc-package-path leksah

Other OS with Gtk+ 3.18 (e.g. Ubuntu 16.04)

stack install --flag ltk:-gtk-320 --flag leksah:-gtk-320
stack exec --no-ghc-package-path leksah

Other OS with Gtk+ 3.16

stack install --flag ltk:-gdk-318 --flag ltk:-gtk-318 --flag leksah:-gtk-318 --flag ltk:-gtk-320 --flag leksah:-gtk-320
stack exec --no-ghc-package-path leksah