Emacs Configuration

Requires Emacs 31+

A vanilla Emacs 31 configuration: modern, minimal, built-in features only. No external packages—just a well-organized collection of Elisp modules that enhance the baseline Emacs experience.

For workflows, keybindings, and detailed how-tos, see HOWTO.md.

Quick start

Clone into ~/.config/emacs/ and launch:

git clone <repo-url> ~/.config/emacs
emacs --init-directory ~/.config/emacs

Architecture

This config is organized as a modular system. At its core are two bootstrap files: init.el and early-init.el, which handle loading and initial setup.

The core modules in lisp/ provide essential functionality: UI rendering, editing, completion, LSP integration, Markdown, and Org writing support. These form the foundation of the configuration and are loaded in a fixed order to ensure proper initialization.

Language-specific modules (lang-python.el, lang-rust.el, etc.) extend support for particular programming languages.

OS-specific modules adapt the configuration for macOS, Linux, and Windows.

Helper scripts in scripts/ support first-party modules where Emacs needs to call out to host OS functionality, such as macOS native spell checking.

Each module is independent; features and keybindings are self-contained and easy to customize or disable.

Support & Navigation

Supported languages:

• Python
• Rust
• C#
• Elisp

Documentation:

• Keybindings and workflows: HOWTO.md
• Detailed feature breakdowns: See module files in lisp/

Writing: Org mode is configured for notes, tasks, agenda basics, and spell checking in Finnish, Swedish, and English. On macOS, org buffers use the native system dictionaries through Flymake diagnostics; elsewhere, or when native checking is unavailable, Hunspell remains the fallback and dictionaries must be installed separately on the host system.

Startup profiling

Check startup performance:

emacs --init-directory ~/.config/emacs --eval '(kill-emacs)'
RK_PROFILE_STARTUP=1 emacs --init-directory ~/.config/emacs