Haskell Yesod web framework vim plugin
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Vim plugin for the Haskell Yesod web framework.


  • Syntax for config/models
  • Syntax for config/routes
  • Syntax for i18n messages/
  • Jump between widget Hamlet, Julius, Lucius and Cassius files
  • Jump to handler files from declared routes
  • Jump to and Create i18n messages
  • Jump to routes and models files
  • Create new handlers for routes under the cursor while in config/routes
  • Touch files with altered TH and Static resources dependencies

Note: This plugin does not add syntax for shakesperean templates, there is another plugin that does: vim-syntax-shakespeare.


Compatible with Vundle, Pathogen, Vim-plug.


yesod.vim gives you some predefined mappings:

Map Command Action
gh :YesodOpenHandler Jump to the handler of the route under the cursor
gH :YesodAddHandler Create a new handler for the route under the cursor
gm :YesodOpenMessage Jump to or create the i18n message under the cursor
ghh :YesodOpenHamlet Open the current widget Hamlet file
ghj :YesodOpenJulius Open the current widget Julius file
ghl :YesodOpenLucius Open the current widget Lucius file
ghc :YesodOpenCassius Open the current widget Cassius file
ghT :YesodTouch Touch modified TH and Static resources files
gym :YesodOpenModels Open models file
gyr :YesodOpenRoutes Open routes file

Open Handler gh

Will jump to the first handler found and fill the location list with each http method available for that handler, so you can jump between them with :lnext and :lprev.

Note: If your using a Vim version <= 7.4.1800, the quickfix list will be used instead (because of a nasty bug in Vim before that version), in which case you use :cnext and :cprev.

Create Handler gH

This will use yesod-bin so be sure you have it installed.

If your project directory structure is not the scaffolding default, this may not work!

Open i18n Message gm

It will always take you to the message for the default language.

Open Hamlet ghh, Julius ghj, Lucius ghl and Cassius ghc files

While in a hamlet, julius, lucius or cassius file you can use any of those commands or default mappings to easily jump to the corresponding file.

Touch files ghT

Whenever you add a new static file (like an image) to static/ or modify a file that depends on template Haskell generation use ghT to touch those, so they are re-built.



You can disable the predefined mappings with:

let g:yesod_disable_maps = 1

And then add your own like:

nnoremap <leader>H :YesodAddHandler<CR>
nnoremap <leader>h :YesodOpenHandler<CR>
nnoremap <leader>m :YesodOpenMessage<CR>

nnoremap <leader>wh :YesodOpenHamlet<CR>
nnoremap <leader>wj :YesodOpenJulius<CR>
nnoremap <leader>wl :YesodOpenLucius<CR>
nnoremap <leader>wc :YesodOpenCassius<CR>

nnoremap <leader>T :YesodTouch<CR>

nnoremap <leader>M :YesodOpenModels<CR>
nnoremap <leader>R :YesodOpenRoutes<CR>


The Yesod default location for handlers is Handler in the project root. If you keep your handlers in more than one directory, lets say for instance: src/ and moreHandlers/, you can configure it like:

let g:yesod_handlers_directories = ['Handler', 'src', 'moreHandlers']

The Handlers directories you define will be searched recursively.

i18n Messages

Default i18n language to use:

let g:yesod_messages_default_lang = "en"

Messages directory:

let g:yesod_messages_path = "messages"


config/models and config/routes files: