List of features provided by aah framework.

aah framework values Go idiomatic and ecosystem. Good read here, here and here.

Server and Extension Points


aah framework uses an enhanced version of forge syntax (very similar to HOCON syntax) for application, route, project, security and i18n config files, etc.

  • Environment profiles are supported. For e.g: dev, qa, prod, etc.
  • Organize your config files as you need, you can always add include references.

URL Routing and Reverse Route

  • Customized version of High performance httprouter.
  • Flexible routes configuration for application, static files and namespace/group.
  • Supports Domains and Sub-domains. Since v0.6 Wildcard subdomain supported. Refer to tutorial.
  • Flexible reverse route URL by route name.
  • Access root domain and subdomain reverse routes easily from view templates and application codebase.
  • Adding Controllers with or without sub-package names for routes. So v1, v2, sub-packages are possible.
  • Redirect Trailing Slash, Auto Options, and Method Not Allowed.
  • Custom Not Found options for non found routes.

Security - Authentication and Authorization

  • aah framework focus on flexible and powerful security implementation, easy to use and understand, it was inspired by Shiro security library. You can design your application secure, stable with authentication, authorization and session management.
  • Exposes clean and intuitive API that simplifies the developer’s effort to make their application secure.
  • Terminology - Security can be really confusing because of the terminology used. To make life easier by clarifying some core concepts, so you understand how they’re reflected in the aah framework. Refer to security terminology.
  • aah security design goals to simplify application security by being intuitive and easy to use. Refer to security design details.
  • Highlights - Authentication, Authorization, Session Management
  • Very flexible, you can implement Role based or Permission based or Role and Permissions based secured application.
  • Out-of-the-box aah framework supports following auth schemes - Form Auth, Basic Auth and Generic Auth.
  • You can define one or more Auth Scheme for your application and can be mapped per route basis.

Security - Session Management

  • aah framework provides stateful and stateless HTTP state management. Default is stateless. It is perfect fit for Web and API application, refer to security configuration.
  • Session data is Signed using HMAC and Encrypted using AES.
  • Out-of-the-box cookie and file session store is supported.
  • You can easily add your own session store.

i18n Internalization and Localization

  • Message files (aka Translation) supported with Language ID + Region ID or Language ID.
    • Language ID follows the two-letter ISO 639-1 standard.
    • Region ID follows the two-letter ISO 3166-1 standard.
  • Default fallback i18n.default if requested Locale is not found.
  • Messages are accessible from View template files, controller as well as anywhere in the application codebase.
  • Organize your message files with sub-directories as you like.
  • Zero coding efforts on localizing your application via header Accept-Language, by URL Query Parameter or by Path Parameter.


  • Go view engine with partial inheritance support (Default engine).
  • Multiple view layouts for your unique use case.
  • Framework provided template funcs, Plus you can add your own easily.
  • Custom template delimiter for templates.
  • You can add your own view engine into the framework, refer here.
  • Since v0.6 You can use without layout too and take full-control of directory structure pages/* along with view rendering via HTML* methods.


Event Publisher/Emitter

Simple and efficient Event Publisher with Asynchronous and Synchronous publish. aah Server extension points built using event publisher.


Reply Builder

  • Simple, efficient and chained Reply builder to compose your response.
  • Supports rich reply types HTML, JSON, JSONP, XML, Text, Binary, File, FileDownload, FileInline, Redirect, etc.

Static File Delivery

aah framework supports flexible and easy to use and configure static file delivery.

  • Serves directory and it’s subtree files.
  • Serves individual files.
  • Directory listing.
  • Since v0.6 Static files Cache-Control by mime types and default one. It gets applied only to prod environment profile. Refer to documentation.
  • Since v0.7 Cache Busting using file name. Refer to documentation.
  • All capabilities of http.ServeContent.


  • Simple to use log library and it’s configuration.
  • Supported Log Level’s are ERROR, WARN, INFO, DEBUG and TRACE.
  • You can create multiple log instances besides the default one.
  • Out-of-the-box Console and File receivers are supported, use Hook for exporting your log to systems like splunk, kibana, etc.
  • File receiver supports daily log rotation, etc.
  • Define your custom log message format (text, json) in the config.
  • Since v0.6 you can bind standard Go logger enabled libraries with aah logger (log.ToGoLogger()), unified log at one place.
  • Since v0.7 supports logger Hook.

HTML Minify

  • Since v0.6 Framework provides HTML minify feature, refer to minify tutorial.
  • HTML minify gets applied only to prod environment profile.

Easy to use Application Binary

  • Easy to build and deploy aah application binary.
  • Cross compile build is supported (aah is only recognizes cross compile build request and setting the appropriate values, Go lang does the rest for you).

Essentials Library

aah helps to increase your productivity, the framework’s essentials library provides a lot of useful helper/util methods in the following areas:

  • filepath
  • GUID (Globally Unique Identifier)
  • Crypto random string, Math random string, random byte generation at fixed length
  • go
  • io
  • os
  • reflect
  • string
  • archive (zip)

Refer to godoc.

Hot-Reload for Development

  • Since v0.7 aah provides Hot-Reload for Development purpose.
  • Fire the aah run and forget the terminal. You can focus on your code and refresh the browser to see your changes.
  • Still lot of improvements can come-in; in-terms of formatted error display, watch files optimization, etc. So keep me posted on your issues. Gradually I will bring improvements :)

Happy coding! Spread the word of aah web framework for Go, Thank you!