A complete redesign of the starter kit for modern Emacs. Faster, easier to maintain, and a proper editor-to-IDE story — while keeping the Wakib promise: the shortcuts you already know, everywhere.
Highlights
- Emacs 30+ required. The kit now builds on what ships with Emacs: use-package, which-key, eglot, project.el, editorconfig and tree-sitter are all built-in.
- Modular config. A slim
init.elplus five small modules (core,ui,completion,editing,dev) and anearly-init.el. Warm startup is roughly twice as fast as before. - Modern completion. Vertico, Orderless, Marginalia, Consult and Embark in the minibuffer; Corfu and Cape in buffers. Tab completes, Return still inserts a newline.
- IDE support.
M-x eglotfor language servers, tree-sitter highlighting with a one-time grammar install prompt per language, Magit onC-e g, projects onC-e p. - Languages out of the box: everything built into Emacs, plus Markdown, YAML, Go, Rust, Lua, TypeScript, Dockerfile and CMake — with classic modes as entry points and graceful fallbacks.
- Better defaults: saved minibuffer history, reopen files at your last position, auto-revert, electric pairs, smooth scrolling, and the built-in modus-vivendi-tinted theme.
Breaking changes when upgrading
- Emacs 30+ is now required — older versions stop with a friendly error at startup.
- Delete your old packages when upgrading in place: run
rm -rf ~/.emacs.d/elpabefore the first start so stale packages don't shadow the ones now built into Emacs. - Ivy/Counsel/Company → Vertico/Consult/Corfu. Day-to-day muscle memory carries over:
C-bswitches buffers,M-i/M-kandM-;/M-:move through candidates. - undo-tree → built-in undo.
C-z/C-S-zare undo/redo;C-e uopens vundo, a visual undo tree. - Projectile → built-in project.el. The prefix is still
C-e p; the common commands (f,p,g) are the same. - Theme is now modus-vivendi-tinted (built-in). Load any theme from
user/init-user.elto override. - Crystal and HAML modes are no longer bundled — see
refs/init-user.el.templatefor how to add them (or any other language) back.
See the README for full details, including the user-override mechanism that keeps your customizations safe across updates.