prelude

Emacs Prelude Prelude is an Emacs distribution that aims to enhance the default Emacs experience. Prelude alters a lot of the default settings, bundles a plethora of additional packages and adds its own core library to the mix. The final product offers an easy to use Emacs configuration for Emacs newcomers and lots of additional power for Emacs power users. Prelude is compatible ONLY with GNU Emacs 29.1+. In general you're advised to always run Prelude with the latest stable Emacs release. I've been developing and maintaining Prelude in my free time for well over a decade. That's a lot of work, and not all of it is fun! Please consider supporting Prelude's ongoing development. Features Improved UX, that's still in line with Emacs traditions Sane defaults of baseline Emacs functionality Automatic installation of many major programming modes on demand A curated set of 3rd party packages to enhance the base functionality Simple modular architecture Easy customization Check out our user manual for more information. Fast Forward Assuming you're using an Unix-like OS (*BSD, GNU/Linux, macOS, Solaris, etc), you already have a recent version of Emacs installed, as well as git & curl you can skip the whole manual and just type in your favorite shell the following command: curl -L https://git.io/epre | sh You can now power up your Emacs, sit back and enjoy Prelude. There are two environment variables you can use to control the source repository and the installation directory. To change the installation directory: export PRELUDE_INSTALL_DIR="$HOME/.emacs.d" && \ curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh To change the source repository: export PRELUDE_URL="https://github.com/yourname/prelude.git" && \ curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh Note that the installer will back up any existing .emacs file or .emacs.d since it will unpack Prelude's code in .emacs.d. If you're doing a manual install make sure you don't have a .emacs file or back up your existing .emacs.d directory manually. Important: Don't forget to adjust your prelude-modules.el file in your personal directory once the installation is done. By default most of the modules that ship with Prelude are not loaded. Try Before You "Buy" If you're using Emacs 29+ there's a simple way to try Prelude (or any other Emacs distro for that matter). Just clone Prelude's repo somewhere and do the following: emacs --init-dir ~/path/to/prelude Philosophy Prelude's philosophy is quite simple: simple easy to understand and extend stable a foundation for you to build upon, as opposed to some end-user product This means that it intentionally doesn't pack all the bells and whistles that it could. Prelude aims to enhance the classic Emacs experience without deviating a lot from it - e.g. it would never enable something like evil-mode (vim keybindings) by default and so on. All the third-party packages that it bundles are carefully vetted and are known to be of good quality and to have reliable maintainers. That generally means that Prelude's unlikely to immediate adopt some shiny new package, that has established tried and true alternatives. In practice this translates to the following: Prelude is less opinionated than distros like Spacemacs and Doom Emacs (meaning it's closer to the standard Emacs experience) Prelude installs relatively few additional packages by default Most modules in Prelude are opt-in instead of opt-out (you'll notice the default config enables only a handful of modules) Most modules (e.g. modules for programming languages) are pretty short and feature setup only for essential packages (in some cases that be just the major mode for the language in question) You don't really need to track Prelude's upstream - you're encouraged to just fork it and use it as the basis for your own configuration. Remember that the ultimate goal of every Emacs user is to create an Emacs setup that reflects their own experience, needs, goals and ideas. Just like Lisp, Emacs is nothing but a raw building material for the perfect editing experience. More installation options are discussed in the installation guide. User Manual While Emacs Prelude is pretty simple at its core, it does have some specifics that are worth learning - e.g. configuration options, load order of modules and personal settings and so on. Check out our user manual for more information. You can also find a lot of information about specific Prelude features and the rationale behind them on my Emacs blog Emacs Redux. crux and super-save A lot of utility commands that used to be part of Prelude were eventually extracted to the crux package, so they'd be easily available to more people. These days Prelude simply depends on that package. The super-save package also used to be part of Prelude in the past. Upgrading to Prelude 2.0 Prelude 2.0 is a major release that modernizes the entire distribution around Emacs 29+ features. Here's what you need to know: Emacs 29.1 is now required Prelude no longer supports Emacs 28 or older. If you haven't upgraded yet, now's the time. Emacs 29 brings built-in tree-sitter, Eglot (LSP client), use-package, and many other improvements that Prelude 2.0 takes full advantage of. Tree-sitter support For languages with both classic and tree-sitter modes (e.g., python-mode / python-ts-mode), Prelude uses the tree-sitter mode when its grammar is available. When it isn't, Prelude offers to install the grammar the first time you open such a file, and uses the classic mode if you say no. Set prelude-treesit-auto-install to always to skip the question, or to nil to never install grammars. M-x prelude-treesit-install-grammars installs the grammars for all of your enabled modules in one go. Some modules use tree-sitter modes that install their own grammars (e.g., prelude-ocaml uses neocaml). See the Emacs manual for more on tree-sitter grammars. Built-in LSP via Eglot Prelude 2.0 adds LS