#+TITLE: NixOS contribution layer for Spacemacs

[[file:img/nixos.jpg]]

* Table of Contents                                                   :TOC@4:
 - [[#description][Description]]
     - [[#features][Features:]]
 - [[#install][Install]]
     - [[#layer][Layer]]
 - [[#key-bindings][Key Bindings]]
     - [[#nixos-options][NixOS Options]]

* Description

This layer adds tools for better integration of emacs in NixOS.

** Features:
- Nix-mode using  [[https://github.com/NixOS/nix/blob/master/misc/emacs/nix-mode.el][nix-mode]]
- Auto-completion of NixOS Options using [[https://github.com/travisbhartwell/nix-emacs/blob/master/company-nixos-options.el][company-nixos-options]]
- Helm Lookup for NixOS Options  [[https://github.com/travisbhartwell/nix-emacs/blob/master/helm-nixos-options.el][helm-nixos-options]]

* Install

** Layer
To use this contribution add it to your =~/.spacemacs=

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers '(nixos))
#+END_SRC

* Key Bindings

** NixOS Options

| Key Binding | Description             |
|-------------+-------------------------|
| ~SPC h >~   | Call helm-nixos-options |