core

Cautiondoomemacs.com is not associated with nor endorsed by this project! doomemacs.org is our one and only domain. Read our announcement about it here. Doom Emacs Install • Documentation • FAQ • Screenshots • Contribute Table of Contents Introduction Features Prerequisites Install Roadmap Getting help Contribute Introduction It is a story as old as time. A stubborn, shell-dwelling, and melodramatic vimmer—envious of the features of modern text editors—spirals into despair before he succumbs to the dark side. This is his config. Doom is a configuration framework for GNU Emacs tailored for Emacs bankruptcy veterans who want less framework in their frameworks, a modicum of stability (and reproducibility) from their package manager, and the performance of a hand rolled config (or better). It can be a foundation for your own config or a resource for Emacs enthusiasts to learn more about our favorite operating system. Its design is guided by these mantras: Gotta go fast. Startup and run-time performance are priorities. Doom goes beyond by modifying packages to be snappier and load lazier. Close to metal. There's less between you and vanilla Emacs by design. That's less to grok and less to work around when you tinker. Internals ought to be written as if reading them were part of Doom's UX, and it is! Opinionated, but not stubborn. Doom is about reasonable defaults and curated opinions, but use as little or as much of it as you like. Your system, your rules. You know better. At least, Doom hopes so! It won't automatically install system dependencies (and will force plugins not to either). Rely on doom doctor to tell you what's missing. Nix/Guix is a great idea! The Emacs ecosystem is temperamental. Things break and they break often. Disaster recovery should be a priority! Doom's package management should be declarative and your private config reproducible, and comes with a means to roll back releases and updates (still a WIP). Check out the FAQ for answers to common questions about the project. Features Minimalistic good looks inspired by modern editors. Curated and sane defaults for many packages, (major) OSes, and Emacs itself. A modular organizational structure for separating concerns in your config. A standard library designed to simplify your elisp bike shedding. A declarative package management system (powered by straight.el) with a command line interface. Install packages from anywhere, not just (M)ELPA, and pin them to any commit. Optional vim emulation powered by evil-mode, including ports of popular vim plugins like vim-sneak, vim-easymotion, vim-unimpaired and more! Opt-in LSP integration for many languages, using lsp-mode or eglot Support for many programming languages. Includes syntax highlighting, linters/checker integration, inline code evaluation, code completion (where possible), REPLs, documentation lookups, snippets, and more! Support for many tools, like docker, pass, ansible, terraform, and more. A Spacemacs-esque keybinding scheme, centered around leader and localleader prefix keys (SPC and SPCm for evil users, C-c and C-c l for vanilla users). A rule-based popup manager to control how temporary buffers are displayed (and disposed of). Per-file indentation style detection and editorconfig integration. Let someone else argue about tabs vs spaces. Project-management tools and framework-specific minor modes with their own snippets libraries. Project search (and replace) utilities, powered by ripgrep and ivy or helm. Isolated and persistent workspaces (also substitutes for vim tabs). Support for Chinese and Japanese input systems. Save a snapshot of your shell environment to a file for Emacs to load at startup. No more struggling to get Emacs to inherit your PATH, among other things. Prerequisites Required: GNU Emacs 27.1–31.1 (31.1 is recommended) Using only Doom's CLI requires 27.1+ Using Doom as a starter kit requires 29.1+ Git >= 2.23 ripgrep >= 11.0 Optional, but recommended: fd 7.3.0+ (used to improve file indexing performance) GNU variants of find, ls, and tar (on MacOS and BSD *nix) Symbola font (Emacs' fallback font for glyphs it can't display) WarningAvoid unstable and pre-release builds of Emacs. These end in .50, .60, or .9X (e.g. 28.1.91). Doom should generally work on Emacs HEAD (the maintainer dogfoods it), but support lags behind the bleeding edge by at least a month or so. ImportantDoom is comprised of ~150 optional modules, some of which may have additional dependencies. Visit their documentation or run bin/doom doctor to check for any that you may have missed. Install git clone --depth 1 https://github.com/doomemacs/core ~/.config/emacs ~/.config/emacs/bin/doom install Then read our Getting Started guide to be walked through installing, configuring and maintaining Doom Emacs. It's a good idea to add ~/.config/emacs/bin to your PATH! Other bin/doom commands you should know about: doom sync to synchronize your private config with Doom by installing missing packages, removing orphaned packages, and regenerating caches. Run this whenever you modify your private init.el or packages.el, or install/remove an Emacs package through your OS package manager (e.g. mu4e or agda). doom sync --env to include a snapshot of your shell environment that Doom will load at startup. This allows Emacs to inherit your PATH, among other things. This replaces exec-path-from-shell. doom upgrade to update Doom to the latest release & all installed packages. doom doctor to diagnose common issues with your system and config. Roadmap Doom is an active and ongoing project. To make that development more transparent, its roadmap (and other concerns) are published across three github project boards and a newsletter: Development Roadmap Packages under review: lists plugins we are watching and considering for inclusion, and what their status for inclusion is. Please consult this list before requesting new packages/features. Upstream bugs: lists issues