Dancer2(3) Lightweight yet powerful web application framework


version 0.200002


Dancer2 is the new generation of Dancer, the lightweight web-framework for Perl. Dancer2 is a complete rewrite based on Moo.

Dancer2 can optionally use XS modules for speed, but at its core remains fatpackable (packable by App::FatPacker) so you could easily deploy Dancer2 applications on hosts that do not support custom CPAN modules.

Dancer2 is easy and fun:

    use Dancer2;
    get '/' => sub { "Hello World" };

This is the main module for the Dancer2 distribution. It contains logic for creating a new Dancer2 application.

You are welcome to join our mailing list. For subscription information, mail address and archives see <>.

We are also on IRC: #dancer on

Documentation Index

Documentation on Dancer2 is split into several manpages. Below is a complete outline on where to go for help.
  • Dancer2 Tutorial

    If you are new to the Dancer approach, you should start by reading our Dancer2::Tutorial.

  • Dancer2 Manual

    Dancer2::Manual is the reference for Dancer2. Here you will find information on the concepts of Dancer2 application development and a comprehensive reference to the Dancer2 domain specific language.

  • Dancer2 Keywords

    The keywords for Dancer2 can be found under DSL Keywords.

  • Dancer2 Deployment

    For configuration examples of different deployment solutions involving Dancer2 and Plack, refer to Dancer2::Manual::Deployment.

  • Dancer2 Cookbook

    Specific examples of code for real-life problems and some 'tricks' for applications in Dancer can be found in Dancer2::Cookbook

  • Dancer2 Config

    For configuration file details refer to Dancer2::Config. It is a complete list of all configuration options.

  • Dancer2 Plugins

    Refer to Dancer2::Plugins for a partial list of available Dancer2 plugins. Note that although we try to keep this list up to date we expect plugin authors to tell us about new modules.

    For information on how to author a plugin, see ``Writing the plugin'' in Dancer2::Plugin.

  • Dancer2 Migration guide

    Dancer2::Manual::Migration provides the most up-to-date instruction on how to convert a Dancer (1) based application to Dancer2.



If it doesn't exist already, "import" creates a new runner, imports strict and warnings, loads additional libraries, creates a new Dancer2 app (of type Dancer2::Core::App) and exports the DSL symbols to the caller.

If any additional argument processing is needed, it will be done at this point.

Import gets called when you use Dancer2. You can specify import options giving you control over the keywords that will be imported into your webapp and other things:

    use Dancer2 '!quux'; # Don't import DSL keyword quux
    use Dancer2 appname => 'MyAwesomeApp'; # Add routes and hooks to MyAwesomeApp
    use Dancer2 ( foo => 'bar' ); # sets option foo to bar (currently not implemented)


my $runner=runner();

Returns the current runner. It is of type Dancer2::Core::Runner.



    Alberto Simões
    Alexis Sukrieh
    Damien Krotkine
    David Golden
    David Precious
    Franck Cuny
    Jason A. Crome
    Mickey Nasriachi
    Russell Jenkins
    Sawyer X
    Stefan Hornburg (Racke)
    Steven Humphrey
    Yanick Champoux


    A. Sinan Unur
    Ahmad M. Zawawi
    Alex Beamish
    Alexander Karelas
    Alexandr Ciornii
    Andrew Beverley
    Andrew Grangaard
    Andrew Inishev
    Andrew Solomon
    Andy Jack
    Ashvini V
    Bas Bloemsaat
    Ben Hutton
    Blabos de Blebe
    Breno G. de Oliveira
    Cesare Gargano
    Charlie Gonzalez
    Chi Trinh
    Christian Walde
    Colin Kuskie
    Dale Gallagher
    Daniel Muey
    David Steinbrunner
    David Zurborg
    Dinis Rebolo
    Erik Smit
    Fayland Lam
    Gabor Szabo
    Gideon D'souza
    Graham Knop
    Gregor Herrmann
    Grzegorz Rożniecki
    Ivan Bessarabov
    Ivan Kruglov
    Jakob Voss
    James Aitken
    James Raspass
    James McCoy
    Jason Lewis
    Javier Rojas
    Jean Stebens
    Jens Rehsack
    Jonathan Scott Duff
    Julien Fiegehenn
    Julio Fraire
    Kaitlyn Parkhurst (SYMKAT)
    Keith Broughton
    Lennart Hengstmengel
    Ludovic Tolhurst-Cleaver
    Mark A. Stratman
    Mateu X Hunter
    Matt Phillips
    Matt S Trout
    Menno Blom
    Michael Kröll
    Michał Wojciechowski
    Mohammad S Anwar
    Nick Patch
    Nick Tonkin
    Nikita K
    Nuno Carvalho
    Olaf Alders
    Olivier Mengué
    Omar M. Othman
    Patrick Zimmermann
    Pau Amma
    Paul Cochrane
    Pedro Bruno
    Pedro Melo
    Peter Mottram
    Philippe Bricout
    Rick Yakubowski
    Ruben Amortegui
    Sam Kington
    Samit Badle
    Shlomi Fish
    Slava Goltser
    Tatsuhiko Miyagawa
    Tina Müller
    Tom Hukins
    Upasana Shukla
    Vernon Lyon
    Victor Adam
    Vince Willems
    Vincent Bachelier
    Joel Berger


Dancer Core Developers


This software is copyright (c) 2016 by Alexis Sukrieh.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.