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" };
dance;
This is the main module for the Dancer2 distribution. It contains logic for creating a new Dancer2
application.
DocumentationIndex
Documentation on Dancer2 is split into several sections. 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.
OtherDocumentation
• Core and Community Policy, and Standards of Conduct
The Dancer core and community policy, and standards of conduct defines what constitutes acceptable
behavior in our community, what behavior is considered abusive and unacceptable, and what steps will
be taken to remediate inappropriate and abusive behavior. By participating in any public forum for
Dancer or its community, you are agreeing to the terms of this policy.
• GitHub Wiki
Our GitHub wiki <https://github.com/PerlDancer/Dancer2/wiki> has community-contributed documentation,
as well as other information that doesn't quite fit within this manual.
• Contributing
The contribution guidelines <https://github.com/PerlDancer/Dancer2/blob/master/Contributing.md>
describe how to set up your development environment to contribute to the development of Dancer2,
Dancer2's Git workflow, submission guidelines, and various coding standards.
• Deprecation Policy
The deprecation policy defines the process for removing old, broken, unused, or outdated code from
the Dancer2 codebase. This policy is critical for guiding and shaping future development of Dancer2.