Skip to content

Install Spacemacsλ︎

Install prerequisites: Emacs, Java 17, Clojure CLI and Command Line tools

  1. Clone or download Spacemacs, removing ~/.emacs.d if it already exists
  2. Clone the practicalli/spacemacs.d configuration to add common layers for Clojure development. Or start Emacs and use the Spacemacs install wizard for basic config, follow the manual configuration section for additional features.
  3. [optional] Install Fira Code font (change dotspacemacs-default-font to a name of a font on your operating system in .spacemacs.d/init.el in step 4)
  4. Install All The Icons fonts for doom modeline theme

Clone Spacemacsλ︎

Use your favourite git client or the following command in a terminal window to clone Spacemacs:

git clone https://github.com/syl20bnr/spacemacs ~/.config/emacs
git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d

Clone Practicalli Spacemacs configurationλ︎

Clone practicalli/spacemacs.d configuration or first create a fork and clone that fork

Using SSH

git clone git@github.com:practicalli/spacemacs.d.git ~/.config/spacemacs

Using HTTPS

git clone https://github.com/practicalli/spacemacs.d ~/.config/spacemacs

~/.config/spacemacs/init.el is the main configuration file, ensure ~/.spacemacs file does not exist as that file would take precedence.

Using SSH

git clone git@github.com:practicalli/spacemacs.d.git ~/.spacemacs.d

Using HTTP

git clone https://github.com/practicalli/spacemacs.d ~/.spacemacs.d

~/.spacemacs.d/init.el is the main configuration file, ensure ~/.spacemacs file does not exist as that file would take precedence.

Emacs custom settings

.spacemacs.d/init.el configuration separates Emacs custom settings into a emacs-custom-setting file. emacs-custom-setting should be added to version control if the Emacs customize menu has been used to define settings. emacs-custom-file is defined in the dotspacemacs/user-init of the Spacemacs configuration

  (setq custom-file (file-truename (concat dotspacemacs-directory "emacs-custom-settings.el")))
  (load custom-file)
A specific path could also be used to define the location of the custom file: (setq custom-file "~/.emacs.d/.cache/custom-settings")

Install Fira Code fontλ︎

Install Fira Code

practicalli/spacemacs.d uses Fira Code, a mono-spaced font designed for source code and includes ligatures and many other features.

Fira Code font - ligatures for Emacs and Clojure code

Use a different font with practicalli/spacemacs.d

To use a different font when using the practicalli/spacemacs.d, edit .spacemacs.d/init.el and update the value for dotspacemacs-default-font to a name of a font on your system.

All The Icon Fontsλ︎

practicalli/spacemacs.d configuration uses the modern looking doom modeline theme, which requires a few fonts and icons.

SPC SPC all-the-icons-install-fonts once Spacemacs is running will install the fonts.

Space q r to restart Spacemacs and see the finished results

Spacemacs - doom-gruvbox-light theme - home and spacemacs config buffers

Spacemacs is ready for actionλ︎

Spacemacs is now up and running and ready to take on the world.

If you already know how to use Spacemacs, jump to the Clojure Projects section, otherwise look through the Spacemacs Basics section to learn how to use Vim style editing and work with files, buffers and windows in Spacemacs.


Last update: January 12, 2023