A package-based, web-centric, customizable, awesome-by-default, acceptance-tested Emacs distribution curated by your friends at Frontside.
Clone or download
Latest commit 1725e43 May 25, 2018
Permalink
Failed to load latest commit information.
scripts Pin js2-mode to MELPA Jul 10, 2017
test Load .mjs file using our javascript mode. Dec 1, 2017
.gitignore hook up to travis Mar 3, 2017
.travis.yml Try a travis hack mebbe? Feb 9, 2018
CHANGELOG.md release 0.2.21 May 25, 2018
Cask migrate to buttercup Apr 9, 2017
Makefile Alter sandboxed init.el to use a typical setup. Mar 13, 2017
README.md Add gitter badge to README (#122) Mar 27, 2018
elpa.svg release 0.2.21 May 25, 2018
frontmacs-completion.el Fix breaking change in `counsel-projectile` Jan 2, 2018
frontmacs-config.el Add configuration and initialization mechanism Mar 15, 2017
frontmacs-css.el Use stable version & remove scss-mode Mar 20, 2017
frontmacs-devel.el create new issue on github. Apr 9, 2017
frontmacs-editing.el Clean up the entire buffer if no region is selected. Mar 9, 2018
frontmacs-javascript.el Disable js2-mode errors Apr 18, 2018
frontmacs-keys.el Vendor zoom-frm dependencies. Feb 9, 2018
frontmacs-markdown.el Add markdown mode (#44) Apr 2, 2017
frontmacs-modeline.el Better comments for modeline setup Apr 26, 2017
frontmacs-pkg.el release 0.2.21 May 25, 2018
frontmacs-projectile.el Move diminishing modes to modeline setup Apr 26, 2017
frontmacs-ruby.el Use vanilla `rspec` executable to run specs. Oct 20, 2017
frontmacs-style.el Move diminishing modes to modeline setup Apr 26, 2017
frontmacs-system.el Remove vkill May 25, 2018
frontmacs-ui.el use simple y/n to answer editing questions. Mar 24, 2017
frontmacs-vcs.el Open current line or region in Github (#42) Mar 31, 2017
frontmacs-web.el Add web-mode config (#24) Mar 17, 2017
frontmacs-windowing.el don't assume that scroll-bar library is loaded. Mar 9, 2018
frontmacs-yaml.el Add yaml & ruby modes (#26) Mar 17, 2017
frontmacs.el Move diminishing modes to modeline setup Apr 26, 2017
vendor-frame-cmds.el Vendor zoom-frm dependencies. Feb 9, 2018
vendor-frame-fns.el Vendor zoom-frm dependencies. Feb 9, 2018
vendor-zoom-frm.el Vendor zoom-frm dependencies. Feb 9, 2018

README.md

Frontmacs

ELPA Version Build Status Join the chat at https://gitter.im/thefrontside/frontmacs

A package-based, web-centric, customizable, awesome-by-default, acceptance-tested Emacs distribution curated by your friends at Frontside.

We've been using Emacs for years here at Frontside, and have finally decided to share the configuration for our favorite editor with the world. Why did we make our own?

Package Based.

We've been satisfied users of many a starter kit over the years, from the original Emacs Starter Kit, to Prelude and Spacemacs. Most starter kits you come across begin with a fork. You clone the repo, and then you're off to the races maintaining your own version. Any customizations you make are made to files under version control and so upgrading and keeping up with the community is a constant battle of merges, rebases, throw-aways and ultimately do overs. We know because we've been there.

This is painful enough when you're maintaining your own fork, but every time we wanted to make a customization from which the entire team could benefit, it involved everybody doing the same merge, rebase, throw-away dance. But, it turns out that Emacs has a mechanism to distribute elisp code without having to use git. It's called ELPA and it's awesome. You can think of it like a Ruby gem or an NPM package, and this is what Frontmacs uses for deployment.

We don't want to maintain code, we just want to enter a few keystrokes and download more awesome. And that's what we get by using elisp packages to install Frontmacs. Now, anytime we fix a bug or make an improvement, the entire team can benefit with a simple upgrade.

Web technologies

We are specialists in UI, and so it is natural that our Emacs distribution reflect that expertise. If you work in the web, then you can be sure that Frontmacs will be an able partner in slinging modern JavaScript using modern frameworks. Whether it's React, React Native, Angular, Ember, SASS.... whatever.

Awesome by Default

Emacs is true ultimate power! But that doesn't mean that it should be intimidating or terrifying to set up. Frontmacs aims to have everything you would expect to have a modern development environment to have out of the box: navigation, completion, etc...

It draws power in a shared configuration in which everybody has a stake. More knowledge shared means fewer bugs arise, and those that do get resolved more quickly.

Customizable

Just because the default set of packages is heavily curated, doesn't mean that there shouldn't be room for you to innovate and exercise your creative muscles.

In fact, because Frontmacs is distributed as an Emacs Lisp package, it is decoupled from git and so you are now free to maintain your own customizations in your own repository without fear of conflicting with the main distribution.

Acceptance Tested

Most of the planet doesn't treat editor configuration as software. We do.

Whenever you integrate a bunch of different packages from across the internet, you're bound to run into conflicts over things like key-bindings, or function advice.

Making changes to an editing experience shared by many people is a responsibility we take very seriously. That's why Frontmacs makes sure that critical behaviors are tested so that you won't get bad upgrades that ruin your day. If you do, you can run the test suite to find out exactly what went wrong and where.


Installation

Download the bootstrap script into your emacs directory

$ cd ~/.emacs.d
$ wget https://raw.githubusercontent.com/thefrontside/frontmacs/master/scripts/init-frontmacs.el

add the following lines to the top of your init.el:

;; boot frontmacs
(load (expand-file-name "init-frontmacs.el" user-emacs-directory))

Restart your Emacs and away you go!


Configuration

Frontmacs will create several files and directories in your Emacs directory (usually $HOME/.emacs.d) to help with configuration and initialization. The first is config.el This file is loaded before Frontmacs actually initializes, and so it's a chance to set any well defined customizations. But don't worry, Frontmacs will generate this file for you so that you can see what all configuration variables are available.

For everything else, there are all of the files contained in $HOME/.emacs.d/initializers. Every elisp file contained in this directory will be evaluated after Frontmacs has been fully configured and initialized, so settings made in these files will override anything that comes with Frontmacs out of the box. For example, you can create your Ruby configuration with a file called:

$HOME/.emacs.d/initializers/ruby.el

(eval-after-load 'rspec-mode
  '(rspec-install-snippets))

(add-to-list 'auto-mode-alist '("Gemfile" . ruby-mode))
(add-to-list 'auto-mode-alist '("\\.gemspec\\'" . ruby-mode))

Just drop any .el file into the initializers/ directory, and Frontmacs will evaluate it.

Note: When in doubt about whether you should put something in config.el or a custom initializer, use an initializer.


Development

You will need a patched version of Cask to do development on.

$ git clone -b specify-package-descriptor --depth=1 https://github.com/cowboyd/cask.git $HOME/.cask
$ export PATH=$HOME/.cask/bin:$PATH

install dependencies

$ cask install

Run an emacs using nothing but the local frontmacs

$ make runlocal