This is my personal KISS Emacs config.

There are many emacs configs, what makes this one different?

This is a keep it simple stupid config. It is built with 3 simple building blocks; small enough that it is white magic instead of black magic.

(defun require-package (package)
  "Ensures that PACKAGE is installed."
  (unless (or (package-installed-p package)
              (require package nil 'noerror))
    (unless (assoc package package-archive-contents)
      (package-refresh-contents))
    (package-install package)))

The code here is self-explanatory. This is how you declare what packages you want to install and use. This was taken from Purcell's config.

(defalias 'after 'with-eval-after-load)

with-eval-after-load lets you defer execution of code until after a feature has been loaded. This is used extensively throughout the config, so an alias is set up for ease of use. This is what keeps the config loading fast.

Another useful feature is that it can also be used to run code if a package has been installed by using -autoloads; e.g.

(after 'magit
  ;; execute after magit has been loaded
  )
(after "magit-autoloads")
  ;; execute if magit is installed/available
  )

This was taken from milkypostman.

At the bottom of the init.el is the following gem:

(cl-loop for file in (directory-files config-directory t)
  when (string-match "\\.el$" file)
  do (load file)))

Basically, it finds anything in config/ and loads it. If you want to add additional configuration for a new language, simply create new-language.el in config/ and it will automatically be loaded. One exception is init-boot.el, which is always loaded first.

Another decision is to keep all keybindings in one place: init-bindings.el. Because of this, things like use-package aren't particularly useful here because it doesn't add much value over (require-package) and after.

Keybindings are the single most differentiating factor between configs. By defining them in one place, if you want to use/fork this config, you can simply change the bindings to your liking and still use all the other preconfigured packages as is. If you're not an Evil user, delete init-evil.el and you will get a pure Emacs experience.

By combining after, require-package, and auto-mode-alist, packages are installed only when necessary. If you never open a Javascript file, none of those packages will be installed.

git clone https://github.com/bling/dotemacs.git ~/.emacs.d

here be dragons.

MIT